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-  Automatic  Data  Processing  Systems  and  Procedures 

H6000  DISK  ANALYSIS  (DIANA)  SYSTEM:  Q038/EK 
COMPUTER  OPERATION  MANUAL 

This  manual  provides  the  H6000  DPI  operations  personnel  with  the 
information  to  operate  the  DIANA  system.  The  DIANA  system  may  be 
executed  through  either  batch  input  from  cards  or  time-sharing 
terminals . 

•"A 

This  manual\has  been  written  to  be  easily  understood  by  its  primary 
audience.  However,  there  are  certain  words  that  are  commonly  used  in 
performing  the  functions  described  here.  These  are  listed  in  the 
paragraph  titled  "Terms  and  Abbreviations."  We  advise  you  to  review 
them  before  reading  this  document. 
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SECTION  1.  GENERAL 

1.1  PURPOSE  OF  THE  COMPUTER  OPERATION  MANUAL.  The  objective  of  this 
computer  operation  manual  for  the  H6000  Disk  Analysis  (DIANA)  System  is 
to  provide  computer  control  and  computer  operator  personnel  with  a 
detailed  operational  description  of  the  system  and  its  associated 
environment  with  which  they  will  be  concerned  during  the  performance  of 
their  duties. 

1.2  PROJECT  REFERENCES.  Documents  pertinent  to  the  DIANA  System  are  as 
follows : 

a.  AFM  171-606,  Volume  II,  H6000  Disk  Analysis  (DIANA)  System: 
Q038/EK. 

b.  AFM  171-100,  Volumes  I  and  II,  Automated  Data  Systems  (ADS) 
Standards,  10  September  1979. 

c.  WWMCCS  SCF  Users  Guide,  Technical  Memorandum,  TM184-78  (Rev  1) ,  1 
December  1978. 

1.3  TERMS  AND  ABBREVIATIONS. 

a.  Allocated  -  Amount  of  disk  space  occupied  by  a  user's  file. 

b.  Assigned  -  Maximum  amount  of  disk  space  available  to  a  UMC. 

c.  Available  -  Disk  space  assigned  but  not  allocated. 

d.  BCD  -  Binary  Coded  Decimal. 

e.  BLINK  -  A  disk  storage  metric:  one  blink  =  five  links. 

f.  Cat  -  Catalog. 

g.  CPE  -  Computer  Performance  Evaluation. 

h.  CPM  -  Computer  Performance  Management. 

i.  Current  LLink  -  A  320-word  block  currently  occupied  by  a  file. 

j.  DIANA  -  H6000  Disk  Analysis  System. 

k.  DPI  -  Data  Processing  Installation. 

l.  FMS  -  File  Management  Supervisor. 

m.  FORTRAN  -  Formula  Translation  Language. 

n.  GCOS  -  General  Comprehensive  Operating  Supervisor. 
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o.  GMAP  -  Macro  Assembler  Program  Language. 

p.  GSEP  -  General  SCF  Expansion  Program. 

q.  GMF  -  Generalized  Monitor  Facility. 

r.  KW  -  A  general  H6000  storage  metric:  one  KW  =  1024  words. 

s.  Link  -  A  disk  storage  metric:  one  link  =  3840  words. 

t.  LLink  -  A  disk  storage  metric:  one  LLink  =  320  words. 

u.  MAJCOM  -  Major  Command. 

v.  PS  -  Program  Specification. 

w.  SCF  -  Statistical  Collection  File. 

x.  SMC  -  System  Master  Catalog. 

y.  SYRUP  -  System  Resource  Utilization  Package. 

z.  SYSOUT  -  System  Output. 

aa.  TSS  -  Time-Sharing  System, 

bb.  UMC  -  User  Master  Catalog. 

cc.  WWMCCS  -  Worldwide  Military  Command  Control  System, 
dd.  XSCF  -  Expanded  Statistical  Collection  File. 
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SECTION  2.  SYSTEM  APPLICATION 

2.1  SYSTEM  APPLICATION.  The  DIANA  system  and  procedures  provide  a 
logical  approach  for  disk  management  on  the  H6000.  The  procedures, 
derived  from  previous  CPM  studies,  are  designed  to  allow  disk  managers 
to  obtain  an  overview  of  the  total  disk  subsystems  in  an  operational 
state.  DIANA  is  a  total  disk  management  system  which  provides  disk 
managers  with  the  capability  to  manage  all  or  selected  portions  of  their 
disk  resource,  regardless  of  configuration. 

2.2  SYSTEM  ORGANIZATION.  DIANA  is  a  modular  system.  Two  monitors 
collect  disk  analysis  data  which  is  in  turn  processed  through  several 
data  reduction  programs  to  produce  both  technical  and  management 
reports . 

a.  Removable  Disk  Monitor.  This  unit  is  comprised  of  the  dynamic 
Disk  Pack  Monitor  and  the  associated  data  reduction  program,  EKM3FO  (see 
figure  2-01) . 

b.  File  Description  Monitor.  This  unit  is  comprised  of  the  Catalog 

File  Description  Monitor,  EKM4F0,  and  the  associated  data  reduction 
programs:  the  Basic  Utilization  Report  Program,  EKM5FO,  and  the  Disk 

Map  Program,  EKM8FO  (see  figure  2-02). 

c.  Disk  Interval  Analysis.  This  unit  deals  with  the  other  data 
reduction  programs,  EKM6F0  and  EKM7F0  (see  figure  2-03),  which  analyzes 
and  produces  reports  from  the  data  base  produced  by  the  Catalog/File 
Descriptor  Monitor. 

2.3  PROGRAM  INVENTORY.  All  DIANA  programs  are  unclassified.  The 
following  seven  programs  are  included  in  this  system: 

2.3.1  EKM1FO.  Removable  Disk  Pack  Monitor  collects  information  about 
removable  spindle  and  pack  utilization  and  stores  it  on  the  SCF  file  in 
user  record  Type  732. 

2.3.2  EKM3FO.  The  Removable  Disk  Pack  Data  Reduction  Program  processes 
Type  732  records  from  the  XSCF  tape  and  produces  reports  on  removable 
disk  pack  usage. 

2.3.3  EKM4FO.  The  Catalog/File  Descriptor  Monitor  accesses  GCOS  system 
tables  and  extracts  information  on  file  and  catalog  activity. 

2.3.4  EKM5FO.  The  Basic  Utilization  Report  Program  generates  five  user 
selected  reports  on  dsk  file  and  catalog  usage. 

2.3.5  EKM6F0.  The  Disk  Interval  Utilization  Program  modifies 
information  collected  by  EKM4F0  to  reflect  activity  of  disk  files  on  a 
time  selectable  basis.  Altered  data  from  EKM6F0  is  next  processed  by 
EKM7FO. 
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2.3.6  EKM7FO.  The  Disk  Pack  Catalog/File  Data  Reduction  Program  creates 
reports  allowing  users  to  analyze  allocation  activity  by  pack,  catalog, 
and  file. 

2.3.1  EKM8F0.  The  Disk  Map  Program  generates  a  map  of  user  file  space 
on  fixed  and  removable  disk. 

2.4  FILE  INVENTORY. 


FILE  ID 

TITLE 

MEDIUM 

DIANA/LIBRARY 

DIANA  System 

Disk 

SCF 

Statistical  Collection  File 

Tape 

XSCF 

Expanded  Statistical 
Collection  File 

Tape 

CEKM3FODU 

Parameters 

Card 

FEKM4FONU 

Data  Base 

Disk/Tape 

CEKM4FODU 

Parameters 

Card 

CEKM5FODU 

Parameters 

Card 

CEKM6FODU 

Parameters 

Card 

FEKM6FONU 

Merged  Data  Base 

Disk/Tape 

CEKM8FODU 

Pa  rameters 

Card 

2.5  PROCESSING  OVERVIEW.  DIANA  does  not  interface  with  any  other 
standard  systems.  Batch  or  time-sharing  execution  can  be  routinely 
accomplished  for  all  programs  except  the  Removable  Disk  Pack  Monitor 
(EKM1FO)  and  the  Catalog/File  Descriptor  Monitor  ( EKM4FO) .  These 
monitors  must  be  executed  as  privileged  slaves  and  require  a  grant  of 
privity  by  the  operator. 

2.5.1  EKM1FO.  This  program  will  respond  tc  the  granting  of  privileged 
slave  status  with  an  initiation  message,  which  is  followed  by  a  request 
for  operator  entry  of  a  sample  time  interval  within  the  limits  15  to  99 
seconds.  The  response  to  the  entry  request  should  be  supplied  by  the 
DPI  disk  manager  prior  to  initiation.  EKM1F0  will  execute  until 
terminated  by  the  operator. 

2.5.2  EKM4FO.  This  program  is  also  a  privileged  slave  but  basically 
collects  static  information.  Following  the  grant  of  privity,  this 
program  will  execute  to  normal  termination  under  program  control.  Since 
each  pack  to  be  examined  by  EKM4FO  must  be  mounted  on-line,  execution  of 
this  program  should  be  limited  to  nonpeak  shifts  whenever  examination  of 
numerous  removable  packs  is  required. 
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2.6  SECURITY  AND  PRIVACY.  The  DIANA  system  (including  inputs,  outputs 
data  base,  programs  and  procedures)  is  unclassified.  There  are  no 
privacy  restrictions  associated  with  use  of  the  system. 
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Figure  2-1.  Removable  Disk  Monitor 
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Figure  2-2.  File  Description  Monitor 
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Figure  2-3.  Disk  Interval  Analysis 
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SECTION  3.  DESCRIPTION  OF  RUNS 

3.1  RUN  INVENTORY.  DIANA  is  composed  of  two  monitors,  EKM1FO  and 
EKM4F0.  These  monitors  collect  information  and  generate  separate  data 
bases  for  use  by  the  data  reduction  programs. 

3.1.1  EKM1FO.  The  Removable  Disk  Pack  Monitor  collects  information  on 
removable  disk  pack  and  spindle  activity. 

3.1.2  EKM3FO.  The  Removable  Disk  Pack  Data  Reduction  Program  produces 
reports  as  needed  for  summary  or  detail  of  pack  and  spindle  activity. 

3.1.3  EKM4FO.  The  Catalog  File  Description  Monitor  gathers  static 
information  on  the  structure,  usage  and  absolute  location  of  cataloged 
files.  The  information  can  be  gathered  on  either  fixed  or  removable 
disk  as  required. 

3.1.4  EKM5FO,  EKM6FO,  EKM7FO  AND  EKM8FO .  These  Catalog  File  Description 
Reports  produce  reports  from  data  gathered  by  disk  monitor  EKM4FO. 
Execution  of  one  or  more  of  these  programs  will  produce  a  variety  of 
reports  which  may  be  selected  on  an  as  required  bases. 

3.2  PHASING.  Phasing  consists  of  user  decision  points  which  evolve  from 
utilization  of  outputs  as  described  in  section  2  of  this  manual. 
Processing  initiated  by  the  user  follows  two  paths  which  are: 

3.2.1  RECORD  CREATION.  EKM1FO  and  EKM4F0  create  data  base  files  which 
contain  disk  utilization  data. 

3.2.2  REPORT  GENERATION.  Data  collected  during  the  record  creation 
phase  is  analyzed  to  produce  reports  according  to  user  requirements  as 
indicated  in  the  program  input  parameters. 

3.3  RUN  DESCRIPTION  -  EKM1FO.  This  disk  monitor  collects  utilization 
data  on  removable  pack  assets  for  output  to  the  SCF  tape  as  a  record 
Type  732.  The  number  of  records  will  vary  depending  on  the  time 
intervals  specified  for  the  collection  of  samples. 

3.3.1  CONTROL  INPUTS.  Job  Control  Language. 

1  8  16 

$  IDENT  (USER  SPECIFIED) 

$  USERID  (USER  SPECIFIED) 

$  PROGRAM  EKM1F0 

$  LIMITS  49 , 3K ,  ,  IK 

** , R , R, USER/RESTORED/LIBRARY 


$ 


PRMFL 
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$  PRIVITY 

$  ENDJOB 

a.  After  initiation  of  the  job,  GCOS  will  ask  for  privity  to  be 
granted.  When  the  operator  grants  privity,  the  following  messages  will 
print  on  the  console: 

(1)  Initiation  Messages. 

EKM1F0  ENTER  TIME  15-99. 

To  this  request  the  operator  must  enter  a  sample  time  between  15  and  99 
seconds  as  specified  by  the  disk  manager.  If  a  wrong  parameter  is 
entered,  this  message  is  printed: 

LIMITS  VIOLATED-REENTER 

(2)  Termination  Message.  The  operator  must  terminate  EKM1F0  to 
stop  processing.  This  will  be  done  at  a  time  specified  by  the  disk 
manager.  Termination  initiates  the  following  message: 

EKM1FO  TERMINATING 

3.3.2  MANAGEMENT  INFORMATION. 

a.  Run  Identification.  Removable  Disk  Pack  Monitor  ( EKM1FO) . 

b.  The  monitor  produces  Type  732  SCF  user  records.  It  is  designed  to 
use  3K  or  less  of  memory. 

c.  Security.  Unclassified. 

d.  Method  of  Initiation.  As  required  through  batch  or  spawned  batch. 

e.  A  waiver  from  the  operational  standards  of  AFM  171-100,  Volume  II, 
has  been  granted  for  use  of  the  $  PRIVITY  control  card  and  the 
nonstandard  console  message. 

f.  Problem  Contacts.  AFDSDC/SCCA,  AUTOVON  921-4021. 

3.3.3  INPUT-OUTPUT  FILES. 

a.  Input  Files.  None. 

b.  Output  Files. 
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FILE  ID  TITLE  CLASS  MEDIUM  D1SP 

SCF  Record  Type  732  Unclas  Tape  DPI 

3.3.4  OUTPUT  REPORTS.  NA. 

3.3.5  REPRODUCED  OUTPUT  REPORTS.  NA. 

3.3.6  RESTART/RECOVERY  PROCEDURES.  There  are  no  specific 
restart/recovery  procedures  for  program  EKM1FO.  Whenever  a  system 
problem  occurs  and  program  EKM1F0  is  terminated,  a  restart  can  be 
accomplished  by  reinitiating  the  job. 

3.4  RUN  DESCRIPTION  -  EKM3F0.  The  Type  732  records  are  extracted  from 
the  SCF  tape  and  expanded  by  GSEP.  These  records  are  then  processed  by 
EKM3FO  to  develop  reports  depicting  removable  pack  and  spindle 
utilization.  A  detail  report  illustrating  spindle  activity  within 
certain  time  intervals  is  also  available. 


3.4.1 

CONTROL  INPUTS. 

Job  Control  Language. 

1 

8 

16 

$ 

IDENT 

(USER  SPECIFIED) 

$ 

USERID 

(USER  SPECIFIED) 

$ 

PROGRAM 

EKM3F0 

$ 

LIMITS 

,  35K 

$ 

PRMFL 

** , R,R, USER/RESTORED/LIBRARY 

$ 

SYSOUT 

06 

$ 

SYSOUT 

10 

$ 

SYSOUT 

11 

$ 

SYSOUT 

12 

$ 

SYSOUT 

13 

$ 

SYSOUT 

14 

$ 

SYSOUT 

15 

$ 

SYSOUT 

16 

$ 

SYSOUT 

17 

$ 

SYSOUT 

18 
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1 

8 

16 

$ 

TAPE9 

02 ,X1D, , NNNNN , ,XSCF-TAPE 

$ 

FILE 

03  ,  X2R , 20L 

$ 

FILE 

04 , X3R , 20L 

$ 

FILE 

SI, SIR, 20R 

$ 

FILE 

S2, S2R, 20R 

$ 

FILE 

S3, S3R, 20R 

$ 

DATA 

( Input 

05 

parameter  card  format  described  in 

AFM  171-606,  Volume  II) 

$  ENDJOB 

NOTE:  The  PRMFL  card  must  reflect  a  program  library  file  previously 

established  by  following  instructions  in  attachment  1. 

3.4.2  MANAGEMENT  INFORMATION. 

a.  Run  Identification.  Removable  Disk  Pack  Data  Reduction  Program 
( EKM3FO)  . 

b.  The  run-time  will  vary  depending  upon  the  amount  of  records  to  be 
analyzed.  The  Detail  by  Report  (PCN  SQ038R02)  volume  of  print  varies 
directly  with  selected  time-interval  input  parameters. 

c.  Security.  Unclassified. 

d.  Method  of  Initiation.  As  required  through  batch  or  spawned  batch 
mode . 

e.  A  waiver  from  the  operational  standards  of  AFM  171-100,  Volumes  I 
and  II,  has  been  granted  to  omit  the  PCN  parameter  control  card  and  for 
use  of  nonstandard  file  codes. 


f.  Problem  Contacts. 


AFDSDC/SCCA,  AUTOVON  921-4021. 


AFM  171-606 

Vol  I  1  February 

1980 

3-5 

3.4.3  INPUT- 

OUTPUT  FILES. 

a.  Input 

Fi les . 

FILE  ID 

TITLE 

CLASS 

MEDIUM 

DISP 

XSCF 

Expanded  SCF 

Unclas 

Tape 

DPI 

CEKM3F0DU 

Input 

Parameters 

Unclas 

Card 

DPI 

b.  Output 

Files.  None. 

3.4.4  OUTPUT 

REPORTS. 

PCN 

TITLE 

CLASS 

MEDIA 

VOLUME 

DISP 

SQ038-R01 

Spindle  Summary 

Unclas 

Printer 

Low 

Disk 

Manager 

SQ038-R02 

Detail  by  Spindle 

Unclas 

Printer 

Varies 

Disk 

Manager 

SQ038-R03 

Summary  by 

Device  Type 

Unclas 

Printer 

Low 

Disk 

Manager 

SQ038-R16 

Input  Records/ 
Parameter  Cards 

Unclas 

Printer 

Low 

Disk 

Manager 

Information 

3.4.5  REPRODUCED  OUTPUT  REPORTS.  NA. 

3.4.6  RESTART/RECOVERY  PROCEDURES. 

a.  Purge  output  in  accordance  with  local  DPI  procedures. 

b.  Correct  cause  of  the  abort. 

c.  Rerun  the  job. 

3.5  RUN  DESCRIPTION  -  EKM4F0.  This  program  collects  data,  at  the  file 
level,  from  GCOS  system  tables.  The  data  collected  contains  file  space 
descriptors  for  files  on  permanent  or  removable  (disk)  media.  Records 
are  stored  on  tape  or  disk  for  further  processing. 

3.5.1  CONTROL  INPUTS.  Job  Control  Language. 

18  16 

$  IDENT  (USER  SPECIFIED) 

$  USERID  (USER  SPECIFIED) 
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1 

8 

16 

$ 

PROGRAM 

EKM4F0 

$ 

LIMITS 

40 , 24K 

$ 

PRIVITY 

$ 

NNNPK 

AA, X1D, ,AAAAA, , PUBLIC  (Note  1) 

$ 

PRMFL 

** ,R,R, USER/RESTORED/LIBRARY  (Note 

$ 

SYSOUT 

06 

$ 

TAPE9 

03,T1S, ,99999, , FEKM4F0NU 

OR 

$ 

PRMFL 

03, W,S, USER/FILE  NAME  (Note  3) 

$ 

DATA 

05 

(Input  parameter  card  format 
described  in  AFM  171-606,  Volume  II) 

* 

*  Subsequent 

*  activities 

$  ENDJOB 

NOTE  1:  Usage  of  NNNPK  is  optional.  The  NNNPK  cards  are  only  needed  if 
information  is  to  be  collected  on  removable  packs.  The  number  of  these 
cards  within  an  activity  can  not  exceed  the  number  of  removable 
spindles.  If  information  is  desired  on  more  packs,  then  subsequent 
activities  will  be  required.  Also,  different  file  codes  for  each  NNNPK 
card  are  required  such  as:  AA,  BB,  CC,  DD,  etc. 

NOTE  2:  The  PRMFL  card  must  reflect  a  program  library  file  previously 
established  by  instructions  in  attachment  1. 

NOTE  3:  This  file  may  be  created  on  either  disk  or  tape  media  as  shown. 
3.5.2  MANAGEMENT  INFORMATION. 

a.  Run  Identification.  Catalog/File  Descriptor  Monitor  (EKM4FO) . 

b.  The  run-time  will  vary  depending  upon  the  size  and  configuration 
of  the  disk  resource  to  be  examined.  Also,  this  program  can  require  the 
mounting  of  several  disk  packs. 

c.  Security.  Unclassified. 


I 
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d.  Method  of  Initiation.  As  required  through  batch  or  spawned  batch 
mode. 

e.  A  waiver  from  the  operational  standards  of  AFM  171-100,  Volumes  I 
and  II,  has  been  granted  for  the  use  of  the  $  PRIVITY  control  card,  for 


omission  of 
nonstandard 

the  standard  PCN 
file  codes. 

parameter  control  card,  and  for 

use  of 

f . 

Problem  Contacts.  AFDSDC/SCCA,  AUTOVON  921-4021. 

3.5.3 

INPUT - 

OUTPUT  FILES. 

a . 

Input 

Files. 

FILE 

ID 

TITLE 

CLASS 

MEDIUM 

DISP 

CEKM4FODU 

Parameters 

Unclas 

Ca  rd 

Disk 

Manage: 

b. 

Output 

Files. 

FILE 

ID 

TITLE 

CLASS 

MEDIUM 

DISP 

FEKM4FONU 

Data  Base 
EKM4F0 

Unclas 

Disk/Tape 

DPI 

3.5.4 

OUTPUT 

REPORTS. 

PCN 

TITLE 

CLASS 

MEDIA  VOLUME 

DISP 

SQ038 

-R19 

Input  Parameter 

Ca  rds 

Unclas 

Printer  Low 

Disk 

3.5.5 

REPRODUCED  OUTPUT  REPORTS.  NA. 

3.5.6  RESTART/RECOVERY  PROCEDURES.  If  job  aborts,  resolve  as  follows: 

a.  Purge  output  in  accordance  with  local  DPI  procedures. 

b.  Correct  cause  of  the  abort. 

c.  Rerun  the  job. 

3.6  RUN  DESCRIPTION  -  EKM5FO.  This  program  generates  reports  for  use  in 
day-to-day  control  of  disk  resources. 


3.6.1  CONTROL  INPUTS.  Job  Control  Language 
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1 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 


8 

I  DENT 

USERID 

PROGRAM 

LIMITS 

PRMFL 

TAPE9 

FILE 

FILE 

FILE 

FILE 

SYSOUT 

SYSOUT 

SYSOUT 

SYSOUT 

SYSOUT 

SYSOUT 

DATA 


16 

(USER  SPECIFIED) 

(USER  SPECIFIED) 

EKM5FO 
,  36K 

**,R,R, USER/RESTORED/LIBRARY  (Note  1) 
08 ,X1D, ,NNNNN , ,  FEKM4FONU  (Note  2) 

09 ,X  2R ,  20L 
SI, SIR, 20R 
S2, S2R , 20R 
S3 , S3R , 20R 

24 

25 

26 

27 

28 
06 
05 


(Input  parameter  card  format 
described  in  AFM  171-606,  Volume  II) 


ENDJOB 


NOTE  1:  The  PRMFL  card  must  reflect  a  program  library  file  previously 
established  by  following  instructions  in  attachment  1. 

NOTE  2:  This  file  may  also  be  on  disk  as  shown  in  paragraph  3.5.1. 

3.6.2  MANAGEMENT  INFORMATION. 


a.  Run  Identification.  Basic  Utilization  Report  Program  (EMK5FO). 

b.  Run-time  varies  directly  with  the  amount  of  data  to  be  analyzed. 
The  volume  of  printing  for  the  Alert  List  (PCN  SQ038-R04) ,  PERM  Disk 
Utilization  Summary  (PCN  SQ038-R05)  and  Removable  Disk  Utilization 
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Summary  (PCN  SQ038-R06)  varies  with  the  amount  of  data  and  the  request 
for  information  by  the  input  parameters. 

c.  Security.  Unclassified. 

d.  Method  of  Initiation.  As  required  through  batch  or  spawned  batch 
mode . 

e.  A  waiver  from  the  operational  standards  of  AFM  171-100,  Volumes  I 
and  II,  has  been  granted  to  omit  the  PCN  parameter  control  card  and  for 
use  of  nonstandard  file  codes. 

f.  Problem  Contacts.  AFDSDC/SCCA,  AUTOVON  921-4021. 

3.6.3  INPUT-OUTPUT  FILES. 

a.  Input  Files. 


FILE  ID 

TITLE 

CLASS 

MEDIUM 

DISP 

FEKM4F0NU 

Data  Base 
EKM4FO 

Unclas 

Tape 

DPI 

CEKM5FODU 

Parameters 

Unclas 

Ca  rd 

DPI 

3.6.4  OUTPUT  REPORTS. 

PCN 

TITLE 

CLASS 

MEDIA 

VOLUME 

DISP 

SQ038-R04 

Alert  List 

Unclas 

Printer 

Varies 

Disk 

Manager 

SQ038-R05 

PERM  Disk  Utiliza¬ 
tion  Summary 

Unclas 

Printer 

Varies 

Disk 

Manager 

SQ038-R06 

RMVBL  Disk  Utiliza¬ 
tion  Summary 

Unclas 

Printer 

Varies 

Disk 

Manager 

SQ038-R07 

H6000  Disk  Status 
Summa  ry 

Unclas 

Printer 

Low 

Disk 

Manager 

SQ038-R08 

List  of  UMC 

Catalogs 

Unclas 

Printer 

Low 

Disk 

Manager 

SQ038-R15 

Parameter  Cards/ 
Errors  List 

Unclas 

Printer 

Low 

Disk 

Manager 

3.6.5  REPRODUCED  OUTPUT  REPORTS. 

NA. 

3.6.6  RESTART/RECOVERY  PROCEDURES 
purpose . 

.  Locally 

determined 

,  based  on 

user 

a.  Purge 

output  in  accordance 

with  local 

DPI  procedures. 
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b.  Correct  cause  of  abort. 

c.  Rerun  the  job. 

3.7  RUN  DESCRIPTION  -  EKM6F0 .  This  program  is  executed  to  provide 
reports  on  file  creation  and  deletion  changes  to  create  a  merged  file 
for  input  into  EKM7F0.  It  should  be  followed  by  EKM7FO  to  produce 
trending  reports. 

3.7.1  CONTROL  INPUTS.  Job  Control  Language. 

18  16 
$  IDENT  (USER  SPECIFIED) 

$  USERID  (USER  SPECIFIED) 

$  PROGRAM  EKM6F0 

$  LIMITS  8 , 20K 

$  PRMFL  **,R,R, USER/RESTORED/LIBRARY  (Note  1) 

$  FILE  01, X3R , 20L 

$  FILE  02 ,X4R , 20L 

$  FILE  03 ,X5S , 20L  (Note  3) 

$  TAPE9  11 ,X1D, ,NNNNN , , FEKM4F0NU  (Note  4) 

$  TAPE9  12,X2D, ,NNNNN,FEKM4F0NU  (Notes  2  and  4) 

$  FILE  SI , , 50R 

$  SYSOUT  10 

$  SYSOUT  20 

$  SYSOUT  06 

(New  activity  of 
EKM7FO) 

$  ENDJOB 

NOTE  Is  The  PRMFL  card  must  reflect  a  program  library  previously 
established  by  following  instructions  in  attachment  1. 

NOTE  2:  File  Code  11  must  be  an  old  data  base  file  from  a  previous 
EKM4FO  activity.  The  creation  date  for  the  data  base  associated  with 
file  code  12  must  be  at  least  one  day  prior  to  the  data  base  creation 
date  for  file  code  12. 
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NOTE  3:  This  is  the  merged  output  file,  FEKM6FONU.  The  "S"  disposition 
code  should  only  be  used  if  the  file  is  for  input  into  EKM7FO. 

Otherwise,  use  an  "R"  disposition  code  such  as:  X5R. 

NOTE  4:  Either  or  both  these  files  may  be  on  disk  as  shown  in  paragraph 
3.5.1. 

3.7.2  MANAGEMENT  INFORMATION. 

a.  Run  Identification.  Disk  Interval  Utilization  Program  (EKM6FO)  . 

b.  Run-time  and  print  volume  varies  directly  with  the  size  of  the 
data  base  to  be  analyzed. 

c.  Security.  Unclassified. 

d.  Method  of  Initiation.  As  required  through  batch  or  spawned  batch 
mode . 

e.  A  waiver  from  the  operational  standards  of  AFM  171-100,  Volume  II, 
has  been  granted  for  the  use  of  nonstandard  file  codes. 

f.  Problem  Contacts.  AFDSDC/SCCA,  AUTOVON  921-4021. 

3.7.3  INPUT -OUTPUT  FILES. 


a.  Input  Files. 


FILE  ID 

TITLE 

CLASS 

MEDIUM 

DISP 

FEKM4F0NU 

Data  Base 
EKM4F0 

Unclas 

Disk/Tape 

DPI 

FEKM4F0NU 

Data  Base 
EKM4F0 

Unclas 

Disk/Tape 

DPI 

NOTE:  The  oldest  EKM4F0NU  file  must  be  associated  with  file  code  11  in 


the  JCL  run 

stream . 

b.  Output 

Fi les . 

FILE  ID 

TITLE 

CLASS 

MEDIUM 

DISP 

FEKM6FONU 

Data  Base 
EKM6F0 

Unclas 

Temp  Disk 

Disk 

Manager 

I 
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3.7.4  OUTPUT  REPORTS. 


PCN 

TITLE 

CLASS 

MEDIA 

VOLUME 

DISP 

SQ038-R09 

Old  Files  Deleted 
Report 

Unclas 

Printer 

Note 

Disk 

Manager 

SQ038-R10 

New  Files  Created 
Report 

Unclas 

Printer 

Note 

Disk 

Manager 

SQ038-R20 

Data  Base  Compari¬ 
son  Error  List 

Unclas 

Printer 

Low 

Disk 

Manager 

NOTE :  The 

print  volume  depends 

upon  the 

variance  between  the 

file 

creation  dates  of  the  EKM4FONU  files.  Normally  the  greater  the 
difference  the  larger  the  print  volume. 

3.7.5  REPRODUCED  OUTPUT  REPORTS.  NA. 

3.7.6  RESTART/RECOVERY  PROCEDURES. 

a.  Purge  output  in  accordance  with  local  DPI  procedures. 

b.  Correct  cause  of  the  abort. 

c.  Rerun  the  job. 

3.8  RUN  DESCRIPTION  -  EKM7FO.  This  program  provides  trend  analysis 
reports  on  disk  utilization.  It  processes  output  from  either  EKM4FO  or 
EKM6FO. 

3.8.1  CONTROL  INPUTS.  Job  Control  Language. 

1  8  16 


$ 

IDENT 

(USER  SPECIFIED) 

$ 

USERID 

(USER  SPECIFIED) 

$ 

PROGRAM 

EKM7FO 

$ 

LIMITS 

,  19K 

$ 

PRMFL 

**,R,R,  USER/RESTORED/LIBRARY  (Note 

$ 

FILE 

'01  ,X5R ,  20L  (Note  1) 

OR 

$ 

TAPE  9 

01 ,X1D, ,NNNNN , , EKM4FONU  (Note  2) 

$ 

FILE 

02  , X1R , 20L 

_ _  '  i  •  in  -  -iiiitfi-Viir  Tiini  riinT 
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1 

8 

16 

$ 

FILE 

03 ,X2R , 20L 

$ 

FILE 

04  ,X4R ,  20L 

$ 

FILE 

SI, SIR, 20R 

$ 

FILE 

S2, S2R , 20R 

$ 

SYSOUT 

06 

$ 

ENDJOB 

NOTE  1:  The  file  associated  with  file  code  01  can  be  generated  from 
either  EKM6FO  or  EKM4F0.  If  EKM7F0  is  run  in  the  same  job  as  EKM6F0, 
then  the  $  FILE  card  should  be  used. 

NOTE  2:  If  EKM7F0  is  run  using  the  data  generated  by  EKM4F0,  then 
either  the  $  TAPE9  card  or  the  $  PRMFL  card  with  the  appropriate  file 
information  should  be  used. 


NOTE  3:  The  PRMFL  card  must  reflect  a  program  library  previously 
established  by  following  instructions  in  attachment  1. 


3.8.2  MANAGEMENT  INFORMATION. 


a.  Run  Identification.  Disk  Pack  Catalog/File  Data  Reduction  Program 
{ EKM7FO)  . 


b.  Run-time  and  print  volume  for 
SQ038-R13)  varies  directly  with  the 
anal yzed . 


File  Allocation  Report  (PCN 
size  of  the  data  base  to  be 


c.  Security.  Unclassified. 

d.  Method  of  Initiation.  As  required  through  batch  or  spawned  batch 
mode . 


e.  A  waiver  from  the  operational  standards  of  AFM  171-100,  Volume  II, 
has  been  granted  for  the  use  of  nonstandard  file  codes. 

f.  Problem  Contacts.  AFDSDC/SCCA,  AUTOVON  921-4021. 
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3.8.3  INPUT-OUTPUT  FILES. 


a.  Input 

Fi les . 

FILE  ID 

TITLE 

CLASS 

MEDIUM 

DISP 

FEKM4FONU 

Data  Base 

EKM4FO 

Unclas 

Di  sk/Tape 

DPI 

OR 

FEKM6FONU 

Data  Base 

EKM6FO 

Unclas 

Di  sk/Tape 

DPI 

NOTE:  Only 

EKM7FO. 

one  of  the  above  files 

is  used 

for  input 

to  any  one 

run  of 

b.  Output 

Files.  None. 

3.8.4  OUTPUT 

REPORTS. 

PCN 

TITLE 

CLASS 

MEDIA 

VOLUME 

DISP 

SQ038-R11 

Pack  Allocation 

Report 

Unclas 

Printer 

Low 

Disk 

Manager 

SQ038-R12 

Catalog  Allocation 
Report 

Unclas 

Printer 

Varies 

Disk 

Manager 

SQ038-R13 

File  Allocation 

Report 

Unclas 

Printer 

Varies 

Disk 

Manager 

SQ038-R17 

Error  List 

Unclas 

Printer 

Low 

Disk 

Manager 

3.8.5  REPRODUCED  OUTPUT  REPORTS.  NA. 

3.8.6  RESTART/RECOVERY  PROCEDURES. 

a.  Purge  output  in  accordance  with  local  DPI  procedures. 

b.  Correct  cause  of  abort. 

c.  Rerun  the  job. 

3.9  RUN  DESCRIPTION  -  EKM8FO.  This  program  generates  a  report  from  the 
EKM4FO  mapping  record.  EKM4FO  must  be  executed  prior  to  this  run. 

3.9.1  CONTROL  INPUTS.  Job  Control  Language. 
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1 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 


8 

IDENT 

USERID 

PROGRAM 

LIMITS 

PRMFL 

FILE 

FILE 

FILE 

FILE 

FILE 

FILE 

SYSOUT 


(USER  SPECIFIED) 

(USER  SPECIFIED) 

EKM8FO 
,  18K 

** , R , R, US ER/ RE STORED/ LIBRARY  (Note  1) 
01 , ,X1D, ,NNNNN , EKM40NU  (Note  2) 

02 , X2R , 20L 
0  3 , X3R , 20L 
SI , SIR , 40R 
S2 , S2R , 40R 
S3 / S3R , 40R 
06 


DATA  05 


(Input  parameter  card  format  described 
from  AFM  171-606,  Volume  II) 


ENDJOB 


NOTE  1:  The  PRMFL  card  must  reflect  a  program  library  previously 
established  by  following  instructions  in  attachment  1. 

NOTE  2:  This  file  may  be  on  disk  as  shown  in  paragraph  3.5.1. 


3.9.2  MANAGEMENT  INFORMATION. 


a.  Run  Identification.  Disk  Map  Program  ( EKM8FO) . 

b.  Run-time  varies  directly  with  the  amount  of  data  to  be  analyzed. 
Print  volume  varies  with  the  request  for  information  by  the  input 
parameters . 

c.  Security.  Unclassified. 

d.  Method  of  Initiation.  As  required  through  batch  or  spawned  batch 
mode . 
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e.  A  waiver  has  been  granted  from  the  operational  standards  of  AFM 
171-100,  Volumes  I  and  II,  to  omit  the  PCN  parameter  control  card  and 
for  the  use  of  nonstandard  file  codes. 

f.  Problem  Contacts.  AFDSDC/SCCA,  AUTOVON  921-4021. 

3.9.3  INPUT-OUTPUT  FILES. 

a.  Input  Files. 


FILE  ID 

TITLE 

CLASS 

MEDIA 

DISP 

FEKM4FONU 

Data  Base 
EKM4F0 

Unclas 

Disk/Tape 

DPI 

CEKM4F0DU 

Parameters 

Unclas 

Card 

DPI 

b.  Output 

Files.  None. 

3.9.4  OUTPUT 

REPORTS. 

PCN 

TITLE 

CLASS 

MEDIA 

VOLUME 

DISP 

SQ038-R14 

Disk  Map 

Unclas 

Printer 

Varies 

Disk 

Manager 

SQ038-R18 

Parameter 

Cards/Errors 

List 

Unclas 

Printer 

Low 

Disk 

Manager 

3.9.5  REPRODUCED  OUTPUT  REPORTS.  NA. 

3.9.6  RESTART/RECOVERY  PROCEDURES. 

a.  Purge  output  in  accordance  with  local  DPI  procedures. 

b.  Correct  cause  of  abort. 

c.  Rerun  the  job. 

BY  THE  ORDER  OF  THE  SECRETARY  OF  THE  AIR  FORCE 


OFFICIAL 


LEW  ALLEN,  JR.,  General,  USAF 
Chief  of  Staff 


VAN  L.  CRAWFORD,  JR.,  Colonel,  USAF 
Director  of  Administration 
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RESTORATION  OF  DIANA  RELEASE  TAPE 

DIANA  is  released  as  a  program  library  file  in  system  loadable  format. 
Restoration  of  the  release  must  be  performed  before  any  programs  can  be 
executed.  The  DIANA  Library  can  be  restored  to  a  permanent  or  temporary 
file.  Examples  of  JCL  needed  to  restore  the  Library  are: 

a.  Program  Library  to  PRMFL. 

1  8  16 

$  IDENT  (USER  SPECIFIED) 

$  USERID  (USER  SPECIFIED) 

$  UTILITY 

$  FFILE  T1 ,  PHYREC 

$  TAPE9  T1,T1D, ,NNNNN, , DIANA-RELEASE 

$  PRMFL  F 1 ,W ,R, UMC/DIANA/ LIBRARY  (see  note) 

$  FUTIL  Tl , FI , RWD/T1/ , RREST/1F/ 

$  ENDJOB 

NOTE:  PRMFL  must  be  created  with  25  links  before  this  job  is  run. 

b.  Program  Library  to  a  temporary  file. 

1  8  16 

$  IDENT  (USER  SPECIFIED) 

$  USERID  (USER  SPECIFIED) 

$  UTILITY  (Note  1) 

$  FFILE  Tl, PHYREC 

$  FILE  W1 , X1S  ,  25R 


$ 


TAPE9 


Tl , X2D, ,NNNNN , , DIANA-RELEASE 


Al-2 
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$  FUTIL  T1,W  -RPEST/1F/ 

(DIANA  Program  (Note  2) 

Activi ties) 

$  ENDJOB 

NOTE  1:  This  activity  must  precede  any  jobs  containing  DIANA  program 
runs. 

NOTE  2:  The  PRMFL  cards  referencing  the  DIANA  Library  in  execution 
activities  must  be  replaced  with  the  following  card: 

1  8  16 

$  FILE  **,X1S 
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Volume  I 
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Automatic  Data  Processing  Systems  and  Procedures 
H6000  DISK  ANALYSIS  (DIANA)  SYSTEM:  Q038/EK 
COMPUTER  OPERATION  MANUAL 
AFM  171-606,  Volume  I,  1  February  1980,  is  changed  as  follows: 

1,  Purpose  of  Change,  To  insert  a  control  card  for  proper  execution  of  EKM5F0  and  to  correct  other 
documentation  errors. 

2.  Write-In  Changes: 


Page 

Re  ference 

1,  i  n  e 

Act  ion 

2-4 

Figure  2-1 

Change  File  ID  for  card  input  from  "CFKM3F0"  to 
"CEKM3P0U." 

2-6 

Figure  2-2 

Change  File  ID  for  card  input  from  "CFKM4F0DU"  to 
"CEKM4P0U." 

Change  File  ID  for  card  input  from  "CFKM5F0DU"  to 
"CEKM5P0U." 

Change  File  ID  for  card  input  from  "CFKM8F0DU"  to 
"CEKM8F0U." 

3-6 

Para  3.6.1 

3 

Change  .the  "24K"  on  the  $  LIMITS  Card  to  "27K." 

3-8 

Para  3.6.1 

8 

Between  the  $  FILE  09  and  $  FILE  SI  cards,  under 
Column  1  heading,  insert  a  "$",  beginning  under 
Column  heading  8,  insert  "FILE"  and  beginning  under 
Column  heading  16,  insert  "10 ,X3R , 20L. " 

3-12 

Para  3.8.1 

8 

Change  the  File  ID  on  the  $  TAPE9  from  "EKM4FONI"'  to 
"FEKM4P0NU." 

3-16 

Para  3.9.1 

6 

Change  the  "FILE"  to  "TAPE9."  After  the  "NNNNN" 
change  to  read  ”,,FEKM4F0NU  (Note  2)". 

A 1  -  1 

Para  a  "NOTE" 

Change  "26  links"  to  "27  links." 

Para  b 

5 

Change  "25R"  to  "27R." 
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AFM  171-606,  volume  I,  1  February  1980,  Is  changed  as  follows: 

1.  Purpose  of  Change,  Modify  documentation  to  allow  for  parameter  Input  to  EKM7F0  and  correct  docu¬ 
mentation  errors. 


2,  Page  Insert  Changes.  New  or  revised  material  is  indicated  by  *. 


Remove 


Date 


Insert 


3-13,  3-14  1  Feb  80 

3.  Write-In  Changes: 


Page 

Reference 

Line 

2-2 

Para  2.4 

12 

2-4 

Figure  2-1 

2-5 

Figure  2-2 

3-4 

Para 

Para 

3.4. 2. e 

3. 4.  2.  f 

1 

3-6 

Para 

3.5.1 

3 

3-12 

Para 

3.8.1 

6 

10 

Al-1 

Para 

b 

7 

Al-2 

Note 

2 

4 
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Action 

Between  FEKM6FONU  and  CEKM8F0DU  under  FILE  ID, 
insert,  "CEKM7FODU".  Under  TITLE,  insert 
"Parameters"  and  under  MEDIUM,  insert  "CARD", 


Change  File  ID  for  card 
"CEKM3F0DU " , 

Change  File  ID  for  card 
"CEKM4F0DU" , 

Change  File  ID  for  card 
"CEKM5FODU " , 

Change  File  ID  for  card 
"CEKM8F0DU”. 

Delete  paragraph. 
Renumber  paragraph  from 
Change  limits  from  ,27K 
Change  limits  from  ,19K 
Under  column  heading  16, 
Under  column  heading  16, 
Under  column  heading  16, 


input  from  "CEKM3F0U"  to 
input  from  "CEKM4FOU"  to 
input  from  "CEKM5F0U"  to 
Input  from  "CEKM8F0U"  to 


“f"  to  "e". 
to  , 29K. 
to  , 21K. 

change  "X1D"  to  "X5D". 
change  "X1S"  to  "Y1S". 
change  "X1S"  to  "Y1S". 
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1 

8 

16 

$ 

FILE 

0  3 ,X2R , 20L 

$ 

FILE 

04 ,X4R , 20L 

$ 

FILE 

SI , SIR , 20R 

$ 

FILE 

S2 , S2R , 20R 

$ 

SYSOUT 

06 

$ 

DATA 

05 

$ 

ENDJOB 

NOTE  1:  The  file  associated  with  file  code  01  can  be  generated  from 
either  EKM6FO  or  EKM4F0.  If  EKM7F0  is  run  in  the  same  job  as  EKM6FO, 
then  the  §  FILE  card  should  be  used. 

NOTE  2:  If  EKM7F0  is  run  using  the  data  generated  by  EKM4F0,  then 
either  the  $  TAPE 9  card  or  the  $  PRMFL  card  with  the  appropriate  file 
information  should  be  used. 

NOTE  3:  The  PRMFL  card  must  reflect  a  program  library  previously 
established  by  following  instructions  in  attachment  1. 

3.8.2  MANAGEMENT  INFORMATION. 

a.  Run  Identification.  Disk  Pack  Catalog/File  Data  Reduction  Program 
(EKM7F0) . 

b.  Run-time  and  print  volume  for  File  Allocation  Report  (PCN 
SQ038-R1 3 )  varies  directly  with  the  size  of  the  data  base  to  be  analyzed 
and  the  monthly  allocation  rate  requested. 

c.  Security.  Unclassified. 

d.  Method  of  Initiation.  As  required  through  batch  or  spawned  batch 
mode . 

e.  A  waiver  from  the  operational  standards  of  AFM  171-100,  Volume  II, 
has  been  granted  for  the  use  of  nonstandard  file  codes. 

f.  Problem  Contacts.  AFDSDC/SCCA,  AUTOVON  921-4021. 


3-14 

AFM 

171-606  Vol  I  (Cl) 

22 

May  1981 

3.8.3  INPUT- 

OUTPUT  FILES. 

a.  Input 

Files . 

FILE  ID 

TITLE 

CLASS 

MEDIUM 

DISP 

FEKM4F0NU 

Data  Base 

EKM4F0 

Unclas 

Disk/Tape 

DPI 

OR 

FEKM6F0NU 

Data  Base 

EKM6F0 

Unclas 

Disk/Tape 

DPI 

CEKM7F0DU 

Parameters 

Unclas 

Card 

DPI 

NOTE:  Only 

EKM7F0. 

two  of  the  above  files 

are  used 

for  input 

to  any  one  run  of 

b.  Output 

Files.  None. 

3.8.4  OUTPUT 

REPORTS. 

PCN 

TITLE 

CLASS 

MEDIA 

VOLUME 

DISP 

SQ036-R1 1 

Pack  Allocation 

Report 

Unclas 

Printer 

Low 

Disk 

Manager 

SQ038-R1 2 

Catalog  Allocation 
Report 

Unclas 

Printer 

Varies 

Disk 

Manager 

SQ038-R13 

File  Allocation 

Report 

Unclas 

Printer 

Varies 

Disk 

Manager 

SQ038-R17 

Parameter  Card/ 

Error  List 

Unclas 

Printer 

Low 

Disk 

Manager 

3.8.5  REPRODUCED  OUTPUT  REPORTS.  NA. 

3.8.6  RESTART/RECOVERY  PROCEDURES. 

a.  Purge  output  in  accordance  with  local  DPI  procedures. 

b.  Correct  cause  of  abort. 

c.  Rerun  the  job. 

3.9  RUN  DESCRIPTION  -  EKM8F0.  This  program  generates  a  report  from  the 
EKM4FO  mapping  record.  EKM4F0  must  be  executed  prior  to  this  run. 

3.9.1  CONTROL  INPUTS.  Job  Control  Language. 
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USERS  MANUAL 

This  manual  provides  the  functional  user  with  the  information  necessary 
to  effectively  use  the  DIANA  system.  It  provides  procedures  and 
information  necessary  to  use  the  system. 

This  manual  has  been  written  to  be  easily  understood  by  its  primary 
audience.  However,  there  are  certain  words  that  are  commonly  used  in 
performing  the  functions  described  here.  These  are  listed  in  the 
paragraph  titled  "Terms  and  Abbreviations."  We  advise  you  to  review 
them  before  reading  this  document. 
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SECTION  1.  GENERAL 

1.1  PURPOSE  OF  THE  USERS  MANUAL.  The  objective  of  this  manual  for  the 
H6000  Disk  Analysis  System  (DIANA)  is  to  provide  ADP  personnel  with 
information  necessary  to  effectively  use  the  system. 

1.2  PROJECT  REFERENCES.  The  DIANA  system  was  developed  for  use  by 
MAJCOM  disk  managers  as  a  tool  for  evaluating  and  improving  the 
effectiveness  and  control  of  disk  resources  on  H6000  systems.  Documents 
pertinent  to  the  DIANA  system  are: 

a.  AFM  171-606,  Volume  I,  H6000  Disk  Analysis  (DIANA)  System: 

Q038/EK. 

b.  Generalized  Monitoring  Facility  (GMF) . 

c.  System  Resource  Utilization  PacLage  (SYRUP). 

d.  AFM  171-100,  Volumes  I  and  II,  Automated  Data  System  (ADS) 
Standards,  1  September  1979. 

e.  WWMCCS  SCF  Users  Guide,  Technical  Memorandum,  TM  84-78  (Rev  1),  1 
December  1978. 

1.3  TERMS  AND  ABBREVIATIONS. 

a.  Active  Blocks  -  Number  of  llinks  active  within  a  specified  time 
interval . 

b.  Allocated  -  Amount  of  disk  space  occupied  by  a  user's  file. 

c.  Assigned  -  Maximum  amount  of  disk  space  available  to  a  UMC. 

d.  Available  -  Disk  space  assigned  but  not  allocated. 

e.  BCD  -  Binary  Coded  Decimal. 

f.  Blink  -  A  disk  storage  metric:  1  blink  =  5  links. 

g.  CAT  -  Catalog. 

h.  Checkerboarding  -  Fragmentation  of  unassigned  disk  space  into 
small  noncontiguous  areas. 

i.  CLINK  -  Ten  times  the  file  monthly  allocation  rate  divided  by  the 
file  size  in  blinks. 


j.  CPE  -  Computer  Performance  Evaluation 

k.  C PM  -  Computer  Performance  Management 
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l.  Current  LLink  -  A  320-word  block  currently  occupied  by  a  file. 

m.  DIANA  -  H6000  Disk  Analysis  System. 

n.  DPI  -  Data  Processing  Installation. 

o.  FMS  -  File  Management  Supervisor. 

p.  FORTRAN  -  Formula  Translation  Language. 

q.  GCOS  -  General  Comprehensive  Operating  Supervisor. 

r.  GMAP  -  Macro  Assembler  Program  Language. 

s.  GSEP  -  General  Summary  Edit  Program. 

t.  KW  -  A  general  H6000  storage  metric:  1  KW  =  1024  words. 

u.  Link  -  A  disk  storage  metric:  1  link  =  3840  words. 

v.  Llink  -  A  disk  storage  metric:  1  llink  =  320  words. 

w.  MAJCOM  -  Major  Command. 

x.  PERM  -  Fixed  permanent  disk  space. 

y.  PS  -  Program  specification. 

z.  SIS  -  Selective  Inquiry  System. 

aa.  Status  Connects  -  An  arbitrary  value  used  to  flag  minimum  device 
activity  when  it  is  polled  less  than  or  equal  to  once  every  eight 
seconds . 

bb.  SMC  -  System  Master  Catalog. 

cc.  SYRUP  -  System  Resource  Utilization  Package, 
dd .  SYSOUT  -  System  output, 
ee.  TSS  -  Time-Sharing  System, 
ff.  UMC  -  User  Master  Catalog. 

gg .  XSCF  -  Expanded  Statistical  Collection  File. 

1.4  SECURITY  AND  PRIVACY.  The  DIANA  system  including  inputs,  outputs, 
data  base,  programs,  and  procedures  is  unclassified.  There  are  no 
privacy  restrictions  associated  with  the  use  of  the  system. 
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SECTION  2.  SYSTEM  SUMMARY 

2.1  SYSTEM  APPLICATION.  The  manner  in  which  a  site's  disk  resource  is 
utilized  and  controlled  greatly  influences  system  efficiency.  The 
information  needed  to  manage  the  disk  resource  in  a  logical  fashion 
becomes  even  more  critical  when  that  resource  is  limited.  H6000  disk 
management  typically  includes  establishing  standards  for  catalogs  and 
files,  assigning  file  space  to  users,  monitoring  use  of  space, 
determining  what  files  should  be  placed  on  fixed  or  removable  disk 
devices,  and  insuring  appropriate  procedures  are  established  for  saving 
and  restoring  the  entire  disk  system. 

The  GCOS  file  system  maintains  numerous  statistics  about  each  cataloged 
file.  Unfortunately,  the  detail  in  the  available  reports  makes  it 
difficult  to  manage  resources  without  extensive  manual  manipulation  of 
the  data . 

In  recent  CPM  studies  involving  disk  management,  specific  strategies 
were  developed  that  employed  the  use  of  various  monitors.  In  addition, 
automated  tools  were  developed  and  applied  to  aid  disk  managers  in 
determining  an  appropriate  balance  between  fixed  and  removable  disk. 

This  document  provides  a  logical  approach,  utilizing  DIANA,  for  disk 
management  on  the  H6000.  The  procedures,  derived  from  previous  CPM 
studies,  allow  managers  to  obtain  an  overview  of  the  disk  system  in  an 
operational  state.  In  addition,  the  procedures  will  permit  the  disk 
manager  to  look  at  selected  portions  of  the  system. 

2.2  SYSTEM  OPERATION.  Either  one  or  both  of  the  data  collection 
programs,  EKM1FO  and  EKM4F0,  are  processed  on  a  site  determined  basis. 
Other  programs  within  DIANA  produce  reports  specified  by  the  user.  The 
data  collected  are  extracted  from  system  tables  maintained  by  GCOS.  The 
data  are  stored  in  a  data  base  (disk/tape)  for  input  to  programs  which 
produce  the  reports  required  by  the  disk  manager.  Proper  use  of  reports 
will  help  the  disk  manager  to:  determine  whether  or  not  adequate 
resources  exist,  isolate  abuses  to  the  system,  determine  proper 
placement  of  files,  optimize  removable  pack  mounts,  and  insure  timely 
acquisition  of  new  disk  resources  for  future  requirements. 

2.3  SYSTEM  CONFIGURATION.  The  DIANA  system  will  be  processed  on  the 
Honeywell  6000  series  ADPE . 

2.4  SYSTEM  ORGANIZATION.  The  DIANA  system  is  comprised  of  seven 
computer  programs: 

a.  Removable  Disk  Pack  Monitor  (EKM1FO).  One  of  two  monitor  programs 
providing  primary  input  to  the  system.  This  program  collects  system 
status  data  on  removable  disk  spindles.  The  data  collected  are  acquired 
from  the  System  Configuration  Table  (SCT)  in  which  are  maintained 
four-word  entries  for  each  device  that  uses  a  multiple  device  channel. 
EKM1FO  will  collect  data  on  removable  configured  DSS181,  DSS190,  DSS191 
and  DSS451  devices.  The  data  include  the  device  type,  device  usage  and 
number  of  connects  to  the  device.  Output  from  EKM1F0  is  written  to  the 
Statistical  Collection  File  (SCF)  in  user  unique  records  -  Type  732.  As 


iMiMfe 


2-2 


AFM  171-606  Vo  1  II 


1  February  1980 


the  data  are  interspersed  with  other  record  types,  GSEP  is  used  to 
extract  and  expand  the  Type  732  record  header  and  create  an  XSCF  tape 
for  input  into  EKM3F0. 

b.  Removable  Disk  Pack  Data  Reduction  Program  (EKM3FO).  This  program 
extracts  record  Type  732  from  the  XSCF  tape.  The  user  may  specify  the 
accumulation  of  data  from  different  time  periods  to  develop  time-series 
maps  showing  where  packs  were  allocated/mounted.  Summary  reports 
depicting  removable  pack  and  spindle  utilization  may  also  be  requested. 
The  reports  include  information  concerning  the  number  of  mounts,  total 
time  mounted,  the  total  time  mounted  that  at  least  one  user  file  was 
allocated,  ratio  of  allocated  to  mounted  time,  and  the  breakdown  of  the 
number  of  spindles  available  for  allocation  during  the  selected  time 
period . 

c.  Catalog/File  Descriptor  Monitor  (EKM4F0).  The  second  monitor 
program  in  the  system  is  EKM4FO.  EKM4FO  collects  detailed  data  from 
available  system  tables  at  catalog  and  file  level.  The  user  has  the 
option  to  collect  data  on  all  permanent  files  stored  either  on  fixed  or 
removable  disk  media.  A  single  activity  can  collect  data  on  either 
fixed  (PERM)  files  or  files  on  removable  media.  If  more  removable  packs 
are  to  be  surveyed  than  there  are  spindles  available,  a  number  of 
separate  activities  or  runs  of  this  monitor  can  be  combined  to  include 
the  entire  removable  disk  pack  population.  A  card  or  card-image  file, 
supplied  by  the  user,  provides  the  pack  numbers  and  device  names  for  all 
removable  disk  packs  and  PERM  packs  to  be  surveyed.  Data  are  collected 
on  User  Master  Catalog  (UMC)  and  Catalog/File  substructures  including  a 
file's  creation  date,  number  of  allocations,  last  date  allocated,  device 
type  and  other  file  sizing  parameters.  These  data,  depending  on  the 
purpose  of  follow-on  processing,  will  aid  day-to-day  control  of  disk 
resources,  trend  analysis,  or  physical  mapping  to  augment  on-going  CPE 
studies.  For  day-to-day  resource  control  or  trending,  data  should  be 
recorded  on  magnetic  tape  and  retained.  CPE  augmentation  data  are 
considered  perishable  and  are  transferred  to  the  subsequent  mapping 
activity  via  a  temporary  disk  file.  The  processing  order  of  the  report 
programs  is  determined  by  the  user's  purpose  for  running  EKM4FO. 

d.  Basic  Utilization  Report  Program  (EKM5F0) .  EKM5F0  provides 
reports  to  aid  day-to-day  control  of  disk  resources.  Input  for  run 
control  and  report  selection  is  via  cards  or  as  card-image  input  with  a 
TSS  job  submission.  EKM5F0  optionally  produces  five  separate  reports: 
the  Alert  List,  the  PERM  and  Removable  Disk  Utilization  Summary,  the 
H6000  Disk  Status  Summary  and  the  User  Master  Catalog  (UMC)  List. 
Decisions  based  on  the  information  contained  in  these  reports  will 
determine  what  further  processing,  if  any,  is  necessary. 

e.  Disk  Interval  Utilization  Program  (EKM6F0).  EKM6FO  is  executed  to 
aid  trend  analysis  of  disk  utilization.  If  trending  is  to  be  based  only 
on  data  produced  during  the  most  recent  run  of  EKM4FO  (a  single  data 
base),  then  the  file  creation  dates  will  provide  the  basis  for  analysis 
and  program  (EKM6F0)  is  bypassed.  If  trending  is  to  be  based  on  a 
processing  interval  (multiple  data  bases)  ,  the  current  data  from  EKM4FO 
will  be  merged  with  data  from  a  previous  run  of  the  monitor.  From  these 
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primary  input(s),  EKM6FO  produces  a  merged  output  file  on  temporary  disk 
and  two  interim  reports:  the  Old  Files  Deleted  Report  and  the  New  Files 
Created  Report.  The  merged  output  file  contains  a  record  for  each 
catalog  and  file  resident  on  disk  throughout  the  interval  between  runs 
of  EKM4F0  and/or  created  and  still  existent  at  the  end  of  the  interval. 
This  file  is  passed  to  a  subsequent  activity  for  data  reduction. 

f.  Disk  Pack  Catalog/File  Data  Reduction  Program  (EKM7F0)  .  Input  for 
EKM7FO  is  dependent  upon  the  method  chosen  for  trend  analysis.  If 
trending  is  to  be  based  on  file  creation  alone,  a  single  current  run  of 
EKM4FO  will  provide  the  input.  When  EKM6F0  has  been  run  to  provide 
trending  over  a  processing  interval,  the  merged  output  file  from  that 
program  will  be  the  input.  The  latter  case  should  be  predominant  and  is 
recommended  for  trend  analysis.  EKM7F0  reduces  the  data  and  produces 
three  detailed  reports  on  system  disk  resource  allocation:  the  Pack 
Allocation  Report,  the  Catalog  Allocation  Report,  and  the  File 
Allocation  Report. 

g.  Disk  Map  Program  (EKM8F0).  EKM8F0  produces  an  ordered  mapping  of 
catalogs  and  files  by  cylinder  address  on  all  selected  disk  media.  The 
data  base  (tape/disk)  created  by  the  monitor  program  (EKM4FO)  is  used  as 
input.  The  report  format  is  designed  to  identify  disk  checkerboarding 
and  file  fragmentation. 

2.5  PERFORMANCE. 

2.5.1  AVERAGE  RESPONSE  TIMES.  Average  response  time  will  vary  depending 
on  the  purpose  of  a  particular  run  and  the  configuration  of  the  site. 

The  data  reduction  programs  may  be  executed  in  routine  batch  or  spawned 
batch  mode  through  the  standard  Time-Sharing  Module.  Response  times  are 
a  function  not  only  of  DIANA  design,  but  also  of  the  number,  size  and 
complexity  of  other  systems  which  are  competing  for  resources.  Because 
these  competitors  are,  at  any  one  point  in  time,  both  Air  Force-standard 
and  command-unique  systems  in  almost  unlimited  combinations,  system 
performance  in  terms  of  response  time  will  vary  considerably  from 
command  to  command. 

2.5.2  LIMITATIONS.  Two  exceptions  to  the  routine  batch  or  spawned  batch 
execution  of  programs  are  the  two  data  collectors:  the  Removable  Disk 
Pack  Monitor  ( EKM1FO)  and  the  Catalog/File  Descriptor  Monitor  ( EKM4FO) . 
These  monitors  must  be  run  as  privileged  slaves  and  require  the  operator 
to  grant  privity. 

2.6  DATA  BASE.  The  DIANA  data  base  is  created  as  follows: 

a.  EKM1F0  collects  data  solely  on  the  status  of  removable  disk 
spindles.  The  data  are  then  stored  in  Type  732  records  on  the  SCF  tape. 
Attachment  1  contains  the  record  format. 

b.  EKM4FO  collects  data  maintained  in  the  GCOS  system  tables  at  the 
catalog  and  file  level.  The  data  are  primarily  file  descriptors  and 
parameters  for  all  permanent  files  stored  on  PERM  or  removable  media.  A 
50-word  record  is  created  by  EKM4FO.  Utilization  of  this  record  depends 
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on  the  purpose  of  the  user.  Attachment  2  contains  the  record  format. 

The  data  collected  are  then  input  to  other  programs  to  create  management 
or  trend  analysis  reports. 

2.1  GENERAL  DESCRIPTION  OF  INPUTS,  PROCESSING,  OUTPUTS.  Following  is  a 
general  explanation  of  the  system  inputs,  processing  and  outputs  by 
program . 

2.7.1  REMOVABLE  DISK  PACK  MONITOR.  EKM1FO  collects  data  on  the  status 
of  removable  disk  spindles  by  writing  record  Type  732  to  the  SCF.  This 
information  is  then  input  to  EKM3F0. 

a.  Inputs.  Input  is  collected  from  the  Secondary  System 
Configuration  Table  (SCT)  which  maintains  four-word  entries  for  each 
device  that  uses  a  multiple  device  channel.  EKM1F0  will  collect  data  on 
removable  configured,  DSS181,  DSS190,  DSS191  and  DSS451  devices.  Data 
collected  on  a  device  include  type,  number,  usage  and  number  of  connects 
to  the  device. 

b.  Processing.  EKM1FO  collects  utilization  data  on  a  maximum  of  50 
removable  devices.  This  is  based  on  the  current  availability  of 
removable  spindles  at  ADPS  10  and  ADPS  80  sites.  Once  EKM1FO  is 
initiated  by  the  operator  and  an  acceptable  sample  time  entered,  the 
program  begins  data  collection  at  the  specified  interval.  Operating  in 
master  mode,  unique  Type  732  records  are  built  from  snapshots  of  the 
Secondary  System  Configuration  Table  and  written  to  the  SCF  tape. 

c.  Output.  The  output  is  a  unique  user  record  Type  732.  Format  and 
content  are  shown  in  attachment  1. 

2.7.2  REMOVABLE  DISK  PACK  DATA  REDUCTION  PROGRAM.  EKM3FO  extracts  Type 
732  records  from  the  XSCF  tape.  It  then  produces  optional  reports 
depicting  removable  pack  and  spindle  utilization.  Multiple  reports  can 
be  produced  on  different  time  periods  specified  by  the  user. 

a.  Inputs.  Inputs  consist  of  XSCF  tapes  containing  Type  732  records, 
and  card  input  parameters  as  covered  in  paragraph  3. 2. 1.2.  Up  to  10 
different  time  periods  can  be  specified  with  an  option  to  produce  three 
different  summary  listings  for  each. 

b.  Processing.  An  initial  sort  of  extracted  Type  732  records 
facilitates  report  processing.  Parameters  for  the  reports  are  read  from 
the  user  furnished  cards  which  specify  the  reports  and  times  intervals 
needed.  Reports  are  generated  according  to  the  parameters  entered. 

c.  Outputs.  A  summary  of  the  monitored  period  and  report  options 
requested  by  the  user  is  produced.  Output  products  consist  of  one  or 
more  of  the  following: 

(1)  Spindle  Summary  Report  (PCN  SQ038-R01).  Provides  a 
summarization  of  activity  occurring  on  each  removable  spindle. 
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(2)  Detail  By  Spindle  Report  (PCN  SQ038-R02) .  Provides  a  detailed 
map  of  time  sequenced  activity  occuring  on  each  removable  spindle. 

(3)  Summary  By  Device  Type  (PCN  SQ038-R03) .  Provides  a 
summarization  of  each  removable  pack  mounted  during  the  monitored 
period  . 


(4)  Input  Records/Parameter  Cards  Information  (PCN  SQ038-R16) . 
Provides  a  summary  of  data  on  the  input  tape  along  with  a  listing  of 
parameters  entered. 

2.7.3  CATALOG/FILE  DESCRIPTOR  MONITOR.  EKM4F0  collects  data  on 
catalog/file  descriptors  for  all  files  on  fixed  or  removable  disk  media. 
This  program  produces  a  data  base  which  is  input  to  EKM5FO,  EKM6F0, 
EKM7FO  or  EKM8FO  depending  on  the  purpose  as  outlined  in  attachment  1. 

a.  Inputs.  Cards  or  card  images  providing  the  type  of  device  to  be 
surveyed.  If  removable  data  is  required,  the  pack  name  must  be  entered. 
Data  are  collected  on  the  specified  packs  from  the  GCOS  systems  tables. 

b.  Processing.  EKM4FO  is  a  privileged  slave  and  requires  operator 
intervention  to  grant  privity.  The  monitor  collects  catalog/file 
descriptor  data  on  specified  media.  A  single  activity  can  collect  data 
on  as  many  packs  as  there  are  removable  spindles.  If  more  packs  are  to 
be  surveyed  than  the  number  of  spindles  available,  multiple  activities 
should  be  combined  to  include  the  entire  removable  disk  pack  population. 

c.  Output.  Outputs  are  50-word  records  written  either  to  a  tape  or 
disk  media  containing  User  Master  Catalogs  and  catalog/file  substructure 
data,  file  creation  date,  number  of  allocations,  last  date  allocated, 
device  type  and  other  file  sizing  parameters.  The  record  format  is 
shown  in  attachment  2. 

2.7.4  BASIC  UTILIZATION  REPORT  PROGRAM.  EKM5FO  produces  five  separate 
summary  reports.  The  disk  manager  should  use  information  contained  in 
these  reports  to  determine  what  further  DIANA  processing  is  necessary. 

a.  Inputs.  Inputs  consist  of  records  produced  by  EKM4F0  and  user 
supplied  card  input  for  record  selection  options.  Options  are  covered 
in  paragraph  3. 2. 1.4  of  this  manual. 

b.  Processing.  Report  options  are  determined  from  the  user  supplied 
cards  before  record  summarization  begins.  File  data  are  accumulated  by 
USERID,  organization,  command  or  system.  Reports  are  then  produced 
according  to  requirements  specified. 

c.  Outputs.  The  following  reports  are  produced: 

(1)  Alert  List  (PCN  SQ038-R04)  .  Lists  files  not  accessed  for  a 
given  number  of  days  residing  on  PERM  disk. 


(2)  PERM  Utilization  Summary  (PCN  SQ038-R05) .  Summarizes 
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utilization  of  fixed  space  for  each  USERID,  organization,  command,  and 
system . 


(3)  Removable  Disk  Utilization  Summary  (PCN  SQ038-R06) . 

Summarizes  the  utilization  of  space  on  removable  packs. 

(4)  H6000  Disk  Status  Summary  (PCN  SQ038-R07) .  Provides  a 
one-page  summary  of  PERM  disk  resources. 

(5)  User  Master  Catalog  List  (PCN  SQ038-R08) .  Provides  a 
summarized  list  of  USERIDs  used  to  track  assignment  of  PERM  space. 

(6)  Parameter  Cards/Error  List  (PCN  SQ038-R15) .  Provides  a  list 
of  parameter  cards  with  any  associated  errors. 

2.7.5  DISK  INTERVAL  UTILIZATION  PROGRAM.  EKM6F0  is  an  aid  to  trend 
analysis  of  file  utilization. 

a.  Inputs.  Input  files  are  generated  by  the  Catalog/File  Descriptor 
Monitor  ( EKM4F0)  . 


b.  Processing.  Input  files  are  sorted  by  catalog/file  strings  for 
summary  reporting.  Each  input  file  is  sorted  and  stored  on  a  temporary 
disk  file  which  is  then  processed  and  merged  onto  the  output  file.  The 
processing  involves  identification  of  three  distinct  catalog/file 
conditions  : 


(1)  Files  created  after  the  older  of  the  two  input  files  was 
created . 


(2)  Files  deleted  prior  to  creation  of  the  newer  input  data  base. 

(3)  Files  common  to  both  data  bases. 

The  first  condition  results  in  a  file  being  listed  on  the  New  Files 
Created  Report  and  a  detail  record  being  written  to  the  merged  output 
file.  The  second  condition  results  in  a  file  being  listed  on  the  Old 
Files  Created  Report.  No  record  is  written  to  the  merged  output  file. 
The  third  and  final  condition  is  handled  in  two  distinctly  different 
ways  depending  upon  the  file  creation  dates.  First,  if  the  creation 
dates  are  different  for  the  same  file  on  both  inputs,  the  files  are 
considered  to  be  different  and  each  is  handled  separately  (as  indicated 
for  conditions  1  and  2).  The  file  on  the  older  data  base  is  written  to 
Old  Files  Deleted  Report  and  the  file  on  the  newer  data  base  is  written 
to  both  the  merged  output  and  the  New  Files  Created  Report.  Second, 
where  file  creation  dates  are  identical,  an  update  is  made  to  the  newer 
of  the  two  records  prior  to  its  being  written  to  the  merged  output  file 


c.  Outputs.  Four  outputs  are  produced. 

(1)  Merged  output  file  which  reflects  file  activity  occurring 
between  two  specified  time  intervals.  This  file  can  be  input  to  EKM7FO 
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(2)  Old  Files  Deleted  Report  (PCN  SQ038-R09) .  Displays  files 
deleted  during  the  time  period. 

(3)  New  Files  Created  Report  (PCN  SQ038-R10) .  Displays  files 
created  during  the  time  period. 

(4)  Data  Base  Comparison  Error  List  (PCN  SQ038-R20) .  Displays 
records  deleted  due  to  file  creation  dates. 

2.7.6  DISK  PACK  CAT/FILE  DATA  REDUCTION  PROGRAM.  EKM7FO  produces 
removable  pack,  catalog,  and  file  reports  from  data  collected  by  EKM4F0 
<>r  irom  the  merged  output  file  of  EKM6FO.  Disk  utilization  at  the 
device  and  catalog/file  level  is  determined  by  calculating  the  number  of 
times  files  associated  with  catalogs  or  devices  are  allocated. 

a.  Inputs.  Inputs  are  EKM4F0  or  EKM6F0  records.  Source  of  input  is 
dependent  on  the  purpose  for  running  EKM7F0. 

b.  Processing.  Two  important  metrics  provide  the  basis  for  three 
reports.  First,  the  Monthly  Allocate  Rate  defined  as  the  total  number 
of  times  the  file  was  allocated  divided  by  the  number  of  days  the  file 
has  been  in  existence  multiplied  by  30  days  per  month.  The  second 
metric  is  the  CLINK  rate,  defined  as  10  times  the  file's  Monthly 
Allocate  Rate  divided  by  the  file  size  in  blinks. 

c.  Outputs.  Four  output  reports  are  possible. 

(1)  Pack  Allocation  Report  (PCN  SQ038-R11) .  Displays  the 
utilization  of  files  associated  with  a  particular  pack  number. 

(2)  Catalog  Allocation  Report  (PCN  SQ038-R12) .  Displays  the 
utilization  of  files  by  catalog. 

(3)  File  Allocation  Report  (PCN  SQ038-R13).  Displays  all  files 
sorted  by  a  monthly  allocation  rate. 

(4)  Error  List  (PCN  SQ038-R17) .  Gives  the  number  of  records,  if 
any,  excluded  from  processing. 

2.7.7  THE  DISK  MAP  PROGRAM.  EKM8F0  provides  a  map  by  catalog/file 
string  of  the  current  location  of  files  on  disk. 

a.  Input.  Input  is  from  the  Catalog/File  Descriptor  Monitor 
( EKM4FO) *  A  ca rd  input  file  specifies  processing  options. 

b.  Processing.  Input  is  sorted  by  physical  location  with  device 
name.  The  temporary  sorted  file  is  then  output  by  cylinder,  indicating 
starting  llink,  ending  llink,  and  file  size  for  each  catalog/file  on  a 
particular  device,  by  name  and  type.  The  acceptable  device  types  are 
DSS180 ,  DSS181,  DSS190,  DSS191  and  DSS451. 

c.  Outputs.  Two  output  reports  are  produced. 
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(1)  Disk  Map  Report  (PCN  SQ038-R14) .  A  report  identifying  the 
location  of  each  file  residing  on  fixed  or  removable  disk. 

(2)  Parameter/Cards  Error  List  (PCN  SQ038-R18) .  Provides  a  list 
of  parameter  cards  with  any  associated  errors. 
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SECTION  3.  STAFF  FUNCTIONS  RELATED  TO  TECHNICAL  OPERATIONS 

3.1  INITIATION  PROCEDURES.  Routine  batch  or  time-sharing  execution  can 
be  accomplished  for  all  but  two  programs.  The  exceptions  are  the  two 
data  collectors:  the  Removable  Disk  Pack  Monitor  ( EKM1F0)  and  the 
Catalog/File  Descriptor  Monitor  (EKM4FO).  These  monitors  must  be 
executed  as  privileged  slaves  and  require  the  operator  to  grant  privity. 

a.  EKM1FO  will  respond  to  the  grant  of  privity  with  an  initiation 
message,  followed  by  a  request  for  operator  entry  of  the  sample  time 
interval.  The  message  clearly  establishes  the  limits  on  the  entry.  The 
response  should  be  supplied  to  the  operator  by  the  DPI  Disk  Manager 
prior  to  initiation.  This  message  is  explained  in  more  detail  in  AFM 
171-606,  Volume  I.  EKM1FO  will  then  execute  until  terminated  by  the 
operator  at  a  time  supplied  by  the  DPI  Disk  Manager. 

b.  EKM4F0  is  executed  as  a  privileged  slave  and  requires  a  grant  of 
privity  by  the  operator.  Otherwise,  the  program  will  execute  as  a 
normal  batch  job. 

3.2  STAFF  INPUT  REQUIREMENTS.  The  DIANA  system  is  designed  for  use  by 
DPI  personnel  only.  Personnel  responsible  for  systems  operation, 
generally  disk  managers  and  system  analysts,  determine  the  inputs. 
Utilization  of  system  outputs  will  be  determined  by  the  initiator. 

Listed  below  are  some  factors  which  should  be  taken  into  consideration . 

a.  Data  Reduction  modules  producing  PCN  SQ038-R02,  PCN  SQ038-R04,  PCN 
SQ038-R1 1 ,  PCN  SQ038-R1 2,  and  PCN  SQ038-R13  should  be  run  during  night 
shifts  due  to  the  large  amount  of  output  possible. 

b.  Initiation  and  processing  of  EKM4F0  should  be  limited  to 
predetermined  night  shifts,  especially  when  specified  inputs  require 
examination  of  numerous  removable  packs.  This  condition  will  require 
multiple  pack  mounts  by  the  operator  and  saturate  removable  resources. 

c.  The  selection  of  input  parameters  should  be  determined  or  approved 
by  the  disk  manager. 

d.  The  parameters  input  to  any  module,  except  EKM1F0,  must  be  in  card 
format  using  either  TSS  batch  (CARDIN)  or  actual  card  input. 

3.2.1  INPUT  FORMATS.  Formats  for  the  DIANA  system  are  discussed,  by 
program,  in  the  following  paragraphs: 

3. 2. 1.1  EKM1F0.  Input  consists  of  three  parameters. 

a.  Start  time. 

b.  Sample  time  (15  to  99  seconds). 

c.  Stop  time. 


mm wmmam 


i 
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All  the  above  parameters  must  be  supplied  to  the  operator  for  program 
initiation.  Additional  information  about  the  console  messages  is 
available  in  AFM  171-606,  Volume  I. 

3. 2. 1.2  EKM3FO.  Input  to  this  program  consists  of  three  optional 
formats.  Formats  are  delineated  by  a  semicolon  and  more  than  one  option 
may  be  specified.  Option  cards  allow  the  user  latitude  in  selection  of 
processing  and  print  intervals.  The  three  formats  are  described  below: 

EKM3FO  CARD  FORMAT  1  POSITION  INSTRUCTIONS 

INCLUDE  FROM  YYMMDD/HH . TTT  1-26  Up  to  10  "Include  From"  cards  may 

TO  YYMMDD/HH. TTT  28-43  be  specified  per  activity.  Dates 

must  be  six  digits  nd  times 
between  00.000  and  24.000.  All 
date-time  intervals  must  be 
mutually  exclusive.  Default  is 
processing  an  entire  XSCF  tape. 


ALL 

After 

44 

Produces  all  reports.  Also, 
default  for  not  supplying  any 
other  options  is  the  production 
of  all  reports. 

SUMMARY 

After 

44 

Produces  Spindle  and  Pack 
Summary  Reports. 

DETAIL 

After 

44 

Produces  Detail  Report  {PCN 
(PCN  SQ038-R02)  only. 

SPINDLE 

After 

44 

Produces  Spindle  Report  (PCN 
SQ038-R01)  only. 

PACK 

After 

44 

Produces  Pack  Report  (PCN 
SQ038-R03)  only. 

/ 

44  or 
Af  ter 

Must  be  present  and  delineates 
end  of  format. 

EKM3FO  CARD  FORMAT  2 

POSITION 

INSTRUCTIONS 

PRINT  INTERVAL  =  HH.TTT  1-23  Allows  optional  printing  of 

detail  lines  on  the  Detail  Report 
at  specified  intervals.  The 
default  is  the  sample  time 
interval  used  by  EKM1FO 
divided  by  3600. 


24  Must  be  present  and  delineates 

end  of  format. 
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INSTRUCTIONS 


3-3 


EKM3FO  CARD  FORMAT  3 
NODUPS 


1-6  Causes  suppression  of  identical 

print  lines  in  the  Detail  Report 
( PCN  SQ038-R02) . 

7  Must  be  present  and  delineates 

end  of  format. 


3. 2. 1.3  EKM4FO.  Input  to  this  program  consists  of  parameters  specifying 
configuration  of  packs  and  their  numbers. 


EKM4FO  CARD  FORMAT  1 
FIXED 


EKM4F0  CARD  FORMAT  2 
FIRST 


EKM4FO  CARD  FORMAT  3 
NEXT 


EKM4F0  CARD  FORMAT  4 
AAAAA 


POSITION  INSTRUCTIONS 


1-5  Entered  if  data  on  all  configured 

PERM  disk  is  required.  This  card, 
if  used,  must  be  input  by  itself 
to  the  first  activity  of  a  job. 

If  removable  disk  pack  data  is 
desired,  additional  activities 
of  EKM4FO  are  required. 

POSITION  INSTRUCTIONS 


1-5  If  data  is  being  collected  on 

removable  packs  only,  this 
parameter  card  is  used  in  the 
first  activity  followed  by  format 
4  cards. 


POSITION  INSTRUCTIONS 


1-4  This  card  is  entered  as  the  first 

parameter  in  succeeding  activi¬ 
ties  to  flag  additional  process¬ 
ing.  This  card  is  then  followed 
by  format  4  cards. 


POSITION  INSTRUCTIONS 

1-5  This  format  specifies  the 

removable  pack  to  be  analyzed. 
Alphanumeric  pack  names  must 
be  entered  in  cc  1-5  and  must 
correspond  to  $NNNPK  cards 
specified  within  this  activity 
to  mount  the  desired  pack . 

As  many  of  these  cards  may  be 
specified  per  activity  as  there 
are  removable  spindles  on  the 
system.  Multiple  activities 
require  cards  with  this  format 
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EKM4FO  CARD  FORMAT  4  POSITION  INSTRUCTIONS 

to  be  preceded  with  card 
format  four. 

3.2. 1.4  EKM5FO.  Input  consists  of  six  different  card  formats.  The 
program  will  accept  the  parameter  cards  in  any  order.  All  options  must 
be  separated  by  a  comma.  An  is  used  as  a  delimiter  for  each  input 

card.  Paragraph  3.2.4  of  this  manual  should  be  carefully  read  and  the 
outputs  examined  before  preparing  input  parameters  for  this  program. 
Input  formats  are  as  follows: 

EKM5F0  CARD  FORMAT  1  POSITION  INSTRUCTIONS 


REPORTS- 

1-8 

Any  combination  of  desired 
reports  may  be  selected.  The 
following  is  a  list  of  key 
words  and  the  PCN  reports  they 
generate : 

ALERT 

After 

8 

Produces  only  Alert  List  (PCN 
SQ038-R04) . 

PERM 

Af  te  r 

8 

Produces  only  Perm  Disk  Utiliza¬ 
tion  Summary  (PCN  SQ038-R05) . 

REMOVABLE 

After 

8 

Produces  only  Removable  Disk 
Utilization  Summary  (PCN  SQ038- 
R06)  . 

DISK  STATUS 

After 

8 

Produces  only  H6000  Disk  Status 
Summary  (PCN  SQ038-R07) . 

UMC 

After 

8 

Produces  only  List  of  User 

Master  Catalogs  (PCN  SQ038-R08) . 

* 

Variable 

Must  be  present  and  delineates 

end  of  format. 

Any  or  all  of  the  options  may  be 
specified,  but  a  comma  is 
required  to  separate  the  options. 
An  asterisk  is  required  follow¬ 
ing  the  last  option  specified  to 
indicate  that  all  the  reports 
desired  have  been  entered. 

Default  is  generation  of  all 
reports . 


AFM  171-606  Vol  II  1 
EKM5FO  CARD  FORMAT  2 
INTERVAL- 

PERM  =NNN 
ALERT=NNN 


EKM5FO  CARD  FORMAT  3 
DISK  STATUS- 


AVAILABLE  LLINKS=NNNN 


SYSTEM  F I LES=NNN 

WORK  AREA=NNN 

* 


February  1980 
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POSITION  INSTRUCTIONS 


1-9 


After  9 
After  9 


This  parameter  allows  the  time 
period  to  be  specified  for  PCN 
SQ038-R04  and  PCN  SQ038-R05. 

"N"s  in  the  format  should  be 
filled  with  two-  or  three-digit 
integers,  specifying  the  number 
of  days  under  investigation. 
ALERT  integer  range  is  between 
30  and  365.  PERM  integer  range 
is  between  15  and  365. 


Default  is  30  days  for  both 
reports.  A  comma  is  required  to 
separate  options. 


Variable  Must  be  present  and  delineates 
end  of  a  parameter  card. 


POSITION  INSTRUCTIONS 

1-12  This  card  is  required  when  the 

option  for  PCN  SQ038-R07  is 
specified.  These  parameters 
must  be  specified  by  the  user, 
since  these  values  are  not 
calculated  within  the  program 
and  have  no  default  values. 


After  12  Total  number  of  llinks  available 
on  the  system.  Calculated  by 
multiplying  the  number  type  of 
disk  configured  as  PERM  by  the 
capacity  of  the  units  in  llinks. 


After  12  Total  number  of  llinks  used  by 
GCOS.  Available  from  a  GCOS 
loadmap. 

After  12  Total  number  of  llinks  set  aside 
for  temporary  working  files. 

Variable  Must  be  present  and  delineates 
end  of  a  card  input. 
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EKM5FO  CARD  FORMAT  3 


EKM5FO  CARD  FORMAT  4 
COMMANDS -CC=AAAAAA 


CC=AAAAAA 


* 


EKM5FO  CARD  FORMAT  5 
STAFF  AGENCIES- 


POSITION  INSTRUCTIONS 

The  above  numeric  fields  are 
limited  to  a  maximum  of  eight 
digits.  They  must  be  separated 
by  commas.  If  required,  they  can 
be  on  separate  cards  with  DISK 
STATUS-  preceding  the  desired 
input . 

POSITION  INSTRUCTIONS 

1-9  This  card  is  used  to  associate 

a  command  code  to  an  expanded 
literal  for  reporting  purposes. 
Standard  command  codes  are  out¬ 
lined  in  AFM  171-100,  Volume  II, 
as  the  first  two  characters  in  a 
USERID. 


After  9  The  command  code  should 

replace  the  "CC"  characters  of 
this  format.  The  literal  for  the 
command  can  be  a  maximum  of  six 
characters  and  follows  the  equal 
sign.  A  maximum  of  20  command 
literal  associations  are  possi¬ 
ble.  They  must  be  separated  by 
commas.  The  last  entry  must  be 
followed  by  an  asterisk.  De¬ 
fault  places  all  command  totals 
under  the  same  labeled  category 
(miscellaneous) . 


NOTE:  Command  codes  should  be 

associated  with  a  literal  to 
enhance  clarity  of  the  reports. 

Variable  Must  be  present  and  delineates 
the  end  of  the  parameter  card. 

POSITION  INSTRUCTIONS 

1-15  This  card  is  used  to  substitute 

an  organization  name  for  USERID 
on  PCNs  SQ038-R06  and  SQ038-R07. 
Up  to  200  unique  associations  may 
be  made,  but  each  should  be  fol¬ 
lowed  by  a  comma  and  an  asterisk 
should  signify  the  last  entry 
on  an  input  card.  The  default 
is  characters  3-6  of  the  USERID 
for  organization  name. 


b. 
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EKM5FO  CARD  FORMAT  5 
AAAAAA=XXXXXX 


EKM5FO  CARD  FORMAT  6 
UNIQUE  UMC- 


U  U  U  U  U  U  =A A AAAA AAA AA A 


* 


POSITION  INSTRUCTIONS 


After  15  The  first  five  characters  of 

a  UMC  replace  the  "A"s.  A  staff 
office  code  between  two  and  six 
characters  replace  the  "X"s. 

If  less  than  six  characters  are 
used,  blanks  will  be  in  the 
remaining  positions. 

NOTE:  Study  examples  in  para¬ 

graph  3.2.4  before  utilizing  this 
option . 

POSITION  INSTRUCTIONS 


1-11  This  card  is  used  to  associate 

nonstandard  UMCs  with  a 
standard  USERID.  Standard 
USERIDs  are  covered  in  AFM  171- 
100,  Volume  II. 


After  11  In  the  format,  the  "U"s  should  be 
replaced  with  the  first  five 
letters  of  the  standard  USERID. 
The  "A"s  should  be  replaced  with 
the  nonstandard  USERIDs,  which 
may  vary  from  two  to  12  charac¬ 
ters  in  length.  Nonstandard 
USERIDs  are  then  separated  by  a 
comma  with  the  last  nonstandard 
USERID  followed  by  an  asterisk. 

Up  to  200  UMC  associations  are 
possible  . 

Variable  Must  be  present  and  delinates 
the  end  of  parameter  card. 


3.2. 1.5  EKM6F0 . 

3. 2. 1.6  EKM7FO. 


No  staff  inputs  are  needed  to  execute  this  program. 
No  staff  inputs  are  needed  to  execute  this  program. 


3. 2. 1.7  EKM8FO .  Input  to  this  program  consists  of  one  or  more  parameter 
cards  which  allow  user  selection  of  device  records  for  processing.  The 
formats  are  as  follows: 


EKM8FO  CARD  FORMAT  1  POSITION  INSTRUCTIONS 

PERM*  1-5  If  more  than  one  type  resides  on 

the  system,  the  types  (180,  181, 
190,  191,  451)  must  be  entered 
beginning  in  column  9  separated 
by  a  comma  . 


i 


i 
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INSTRUCTIONS 

NOTE:  If  this  card  is  used  it 

must  be  the  first  input  card. 

INSTRUCTIONS 

Use  this  parameter  to  map  remov¬ 
able  packs.  The  number  of  packs 
to  be  mapped  should  replace  the 
N"s.  No  delimiter  is  required. 
This  card  is  followed  by  input 
from  card  format  three. 

INSTRUCTIONS 

The  "XXXXX" s  should  be  replaced 
with  a  pack  name  and  the  bttT”s 
with  the  type  of  pack.  The 
number  of  cards  with  this 
format  must  be  the  same 
number  as  entered  on  card 
format  two. 

3.2.2  COMPOSITION  RULES.  All  parameters  should  start  in  card  column  one 
unless  otherwise  specified.  Grammatical  rules  and  punctuation  that  must 
be  observed  in  order  to  prepare  input  are  covered  by  parameter  card  in 
paragraph  3.2.1. 

3.2.3  INPUT  VOCABULARY.  NA. 

3.2.4  SAMPLE  INPUTS.  Sample  inputs  are  presented  in  this  section  for 
each  program. 

3. 2.4.1  THE  REMOVABLE  DISK  PACK  MONITOR  (EKM1FO) . 

a.  Parameter  Inputs.  After  initiation  of  the  JCL  found  in  AFM 
171-606,  Volume  I,  GCOS  will  ask  for  privity  to  be  granted.  After 
privity  is  granted  the  following  message  will  print  on  the  console: 

-  -  -  EKM1F0  IN  EXECUTION  -  -  -  ENTER  SAMPLE  TIME  (NN  SECS,  15  to  99) 

The  operator  will  then  input  a  value  from  15  to  99.  The  input  sample 
interval  is  the  time  between  snapshots  of  the  SCT.  Records  will  be 
written  to  the  SCF  according  to  this  parameter.  The  user  must  also 
provide  the  time  of  day  when  the  operator  should  terminate  the  monitor. 

3. 2.4.2  THE  REMOVABLE  DISK  PACK  DATA  REDUCTION  (EKM3F0) . 

a.  Parameter  Inputs.  A  maximum  of  10  different  time  intervals  with 
the  three  following  reports  are  possible  per  XSCF  tape:  Spindle  Summary 
( PCN  SQ038-R01) ,  Detail  By  Spindle  (PCN  SQ038-R02) ,  and  Summary  By 
Device  Type  (PCN  SQ038-R03) .  The  absence  of  any  parameter  cards  will 


EKM8FO  CARD  FORMAT  1 


POSITION 


EKM8FO  CARD  FORMAT  2 


POSITION 


RMVBL* 

NNN 


1-6 

9-12 


EKM8FO  CARD  FORMAT  3 


POSITION 


XXXXX 

TTT 


1-5 

9-11 
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cause  production  of  all  reports  covering  every  record  contained  on  the 
XSCF  tape.  The  following  are  examples  of  the  parameter  cards: 

(1)  In  the  example  below  all  three  reports  will  be  generated  for 
records  from  00.000  24.000  hours  on  16  Mar  79.  NODUPS  will  cause 
suppression  of  duplicate  lines  of  print. 


Example : 

INCLUDE  FROM  790316/  TO  790417; 

NODUPS; 

(2)  In  the  example  below  the  Spindle  Report  (PCN  SQ038-R01)  and 
the  PACK  Report  (PCN  SQ038-R03)  will  be  produced  for  all  records  on  3 
Mar  79  from  0930  to  1700. 

Example : 

INCLUDE  FROM  790316/09.500  TO  790316/17.000  SUMMARY; 

(3)  In  the  example  below  only  the  Detail  Report  (PCN  SQ038-R02) 
will  be  produced  on  records  from  1700  on  16  Mar  79  to  2400  on  17  Mar  79. 
The  PRINT  INTERVAL  option  has  been  used  and  will  cause  details  line  on 
the  Detail  Report  to  be  printed  every  three  minutes. 

Exampl e : 

INCLUDE  FROM  790316/17.000  TO  790317/24.000  DETAIL; 

PRINT  I NTERVA L=00.050; 

(4)  In  the  example  below  all  reports  are  produced  on  all  records 
contained  on  the  XSCF  tape.  Duplicate  print  lines  are  suppressed  on  the 
Detail  Report  (PCN  SQ038-R02),  since  the  NODUPS  option  is  used.  Also, 
the  print  interval  will  default  to  sample  time  of  EKM1FO  divided  by 
3600. 

Example : 

NODUPS; 

3.2. 4. 3  THE  CATALOG/FILE  DESCRIPTOR  MONITOR  ( EKM4FO) . 

a.  Parameter  Inputs.  Multiple  sets  of  parameter  cards  and  JCL  may  be 
required  to  examine  large  removable  pack  populations.  The  maximum 
number  of  removable  packs  to  be  interrogated  per  activity  is  limited  to 
the  number  of  removable  spindles  on  the  system.  $  NNNPK  cards  must  be 
present  within  the  activity  for  each  removable  pack  to  be  examined  in 
that  activity.  Each  requested  pack  within  an  activity  must  have  a 
unique  file  code;  such  as,  AA,  BB,  CC,  DD,  etc.  There  are  four  parameter 
card  formats.  The  following  are  examples  of  their  use: 

(1)  This  format  must  be  in  a  separate  activity  as  the  only  input. 
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The  following  will  generate  data  on  PERM  files: 

Example : 

FIXED 

(2)  The  parameter  "FIRST"  is  used  in  the  first  activity  of  runs 
collecting  only  information  on  removable  packs.  A  flag  is  set  signaling 
the  monitor  that  this  is  the  first  activity  of  a  job  collecting 
information  on  removable  packs;  succeeding  cards  specify  packs  to  be 
examined  in  the  first  activity. 

Example : 

FIRST 

DP001 

DP002 

DP003 

(3)  The  parameter  "NEXT"  is  used  with  each  subsequent  activity 
which  examines  removable  packs.  It  is  also  followed  by  cards  specifying 
packs  to  be  examined. 

Example : 

NEXT 

DP004 

DP005 

DP006 

DP007 

3. 2. 4. 4  BASIC  UTILIZATION  REPORT  PROGRAM  ( EKM5FO) . 

a.  Parameter  Inputs.  The  six  input  formats  which  provide  the  user 
control  over  report  selection  are  described  in  the  following: 

(1)  In  this  example,  card  format  one  has  been  used  to  request  the 
PERM  Disk  Utilization  Summary  (PCN  SQ038-R05) ,  Removable  Disk 
Utilization  Summary  (PCN  SQ038-R06) ,  H6000  Disk  Status  Summary  (PCN 
SQ038-R07) ,  List  of  UMCs  (PCN  SQ038-R08) . 

Example : 

RE PORTS -PERM , DISK  STATUS , UMC , REMOVABLE* 

(2)  In  this  example,  the  "INTERVALS"  parameter  card  has  been  used 
to  set  the  interval  of  investigation  on  the  Alert  List  (PCN  SQ038-R04) 
to  90  days  and  the  internal  on  the  PERM  Disk  Utilization  Summary  to  60 
days . 


Example : 

INTERVALS-PERM=60 ,ALERT=90* 
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(3)  In  this  example,  card  format  three  is  used  to  input  three 
values,  which  the  user  must  supply  to  produce  PCN  SQ038-R07.  Total 
available  llinks  on  the  system  has  been  entered  as  258,000,  the  amount 
of  space  used  by  system  files  is  48,000  llinks,  and  temporary  work  space 
has  been  set  at  99,500  llinks. 

Example : 

DISK  STATUS -AVAILABLE  LLINKS=2 5800 0 , SYSTEM  FILES=48000* 

DISK  STATUS-WORK  AREA=99500* 

(4)  In  this  example,  card  format  five  provides  command  breaks  for 
PCN  SQ038-R05 ,  PCN  SQ038-R06,  PCN  SQ038-R07,  and  PCN  SQ038-R08.  It  also 
provides  a  command  name  to  be  substituted  for  command  code  for  report 
purposes . 

Example : 

COMMANDS -FO=DSDC,FK=AU* 

(5)  In  this  example,  card  format  six  provides  names  which  are 
substituted  for  organi za ti ona 1  totals  in  PCN  SQ038-R05  and  PCN 
SQ038-R06. 

Example : 

STAFF  AGENC IES-FKCSC=ACSC, FKAIC=AI/FOS* 

STAFF  AGENC IES-F0PGC=PHASE4* 

STAFF  AGENC IES-FKRTC=ROTC, F0SDT=SDS, FKLMD=LMDC* 

(6)  In  this  example,  card  format  seven  is  used  to  associate 
nonstandard  USERIDs  to  standard  USERIDs.  This  allows  all  the  attributes 
of  a  nonstandard  USERID  to  be  accumulated  under  a  specified  UMC. 

Example : 

UNIQUE  UMC-F0PRD=W0RD-PR0C , SARA-H , TAPELIBR* 

UNIQUE  UMC-FOSDM=SWAP, FOSDAA , DATAMGT, PSOLUS , SYSLIB* 

3. 2. 4. 5  THE  DISK  INTERVAL  UTILIZATION  PROGRAM  (EKM6F0). 
a.  No  parameter  inputs  are  required. 

3. 2.4.6  THE  DISK  PACK  CATALOG/FILE  DATA  REDUCTION  PROGRAM  ( EKM7F0) . 

a.  Parameter  Inputs.  Parameter  inputs  are  not  required  for  this 
prog  ram . 

3. 2.4.7  THE  DISK  MAP  PROGRAM  ( EKM8F0) . 

a.  Parameter  Inputs.  Inputs  to  this  program  specify  which  devices  on 
PERM  or  which  removable  packs  are  to  be  mapped. 
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(1)  In  the  following  example  the  user  has  specified  for  all  181 
and  451  PERM  disk  to  be  mapped,  along  with  two  removable  packs  for  each 
of  these  type  devices: 


Example : 

PERM* 

181,451 

RMVBL* 

4 

DP001 

181 

DP002 

181 

DP003 

451 

DP004 

451 

(2)  In  the  following  example  the  user  has  specified  that  only  the 
PERM  disk  be  mapped: 

Example : 

PERM* 


(3)  In  the  following  example  the  user  has  specified  that  only  two 
removable  packs  be  mapped: 

Example : 

RMVBL*  2 
DP001  451 

DP002  191 


3.3  OUTPUT  REQUIREMENTS.  Output  requirements  vary  depending  on  the 
purpose  and  the  amount  of  data  the  user  has  chosen  to  examine.  The  two 
monitors,  EKM1FO  and  EKM4FO,  generate  data  records.  These  records  are 
then  input  into  the  appropriate  data  reduction  program  for  desired 
reports.  The  use  of  these  reports  is  discussed  in  detail  in  paragraph 
3.4. 


3.3.1  OUTPUT  FORMATS. 

3. 3. 1.1  PCN  SQ038-R01,  SPINDLE  SUMMARY  REPORT.  (See  figure  3-1)  This 
report  provides  a  summarized  list,  by  spindle  type  and  name,  of  the 
number  of  packs  mounted,  allocated  time  (time  pack  was  mounted  and  user 
files  were  open),  and  percent  of  time  that  a  spindle  was  allocated  over 
a  time  interval.  The  number  of  spindles  available  for  assignment  by  the 
peripheral  allocator  during  the  sample  period  is  shown  in  the  upper 
right-hand  corner  of  the  report.  The  trailer  contains  information  about 
the  sequence  of  produced  reports.  "SECTIONS"  correspond  to  the  order 
and  number  of  reports  within  the  requested  intervals.  "PART" 
corresponds  to  the  different  types  of  devices  included  within  the 
report . 

3. 3. 1.2  PCN  SQ038-R02 ,  DETAIL  BY  SPINDLE  REPORT.  (See  figure  3-2)  This 
report  provides  a  detailed  look  at  activity  occurring  on  each  spindle 
configured  for  removable  packs.  Directly  under  each  spindle  name  the 
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status  is  shown  by  the  columns  "PACK"  and  "USAGE”.  Under  the  "PACK" 
column  a  spindle  may  be  assigned  waiting  for  a  pack  (shown  by 
"A:DPNNN").  The  spindle  may  be  empty  and  unassigned  shown  by  "OPEN"  or 
it  may  have  a  pack  mounted  shown  by  the  pack  name.  The  "USAGE"  column 
shows  the  number  of  user  files  open.  Asterisks  are  printed  beside  the 
usage  counts  that  have  only  status  connects  attributed  to  user's  files. 
The  trailer  format  corresponds  to  the  tailer  description  in  paragraph 
3. 3. 1.1. 

3. 3. 1.3  PCN  SQ038-R03,  SUMMARY  BY  DEVICE  TYPE.  (See  figure  3-3)  This 
report  provides  a  list  of  all  the  packs  mounted  during  the  monitored 
time.  Information  displayed  on  each  pack  is  the  number  of  times  the 
pack  was  mounted,  the  total  time  the  pack  was  mounted  on  a  spindle,  the 
allocated  time  (time  a  pack  was  mounted  that  a  user  file  was  open),  and 
percentage  of  time  the  user  had  files  allocated  the  total  mounted  time. 
Also,  the  number  of  status  connects  divided  by  allocation  percent  are 
shown  giving  the  percent  of  allocated  time  that  only  status  connects 
were  occurring  to  the  pack. 

3. 3. 1.4  PCN  SQ038-R04,  ALERT  LIST.  (See  figure  3-4)  The  report 
provides  a  list  by  UMC  of  catalog  file  strings  that  have  not  been 
accessed  for  a  specified  number  of  days.  The  "AS  OF"  date  is  the  date 
the  data  base  was  collected.  The  "ACCESS  SINCE"  date  is  used  to 
determine  what  catalog  file  strings  are  to  be  listed.  It  is  computed  by 
substracting  the  number  of  days  indicated  on  card  format  two  of  EKM5F0 
from  the  "AS  OF"  date.  Across  from  the  catalog  file  strings  are  the 
file  attributes  of  each  individual  file.  "CREATION  DATE"  is  the  date 
the  file  was  created.  "LAST  DATE  ALLOCATED"  is  the  last  date  the  file 
was  accessed.  "MAXIMUM  NO.  LLINKS"  is  the  maximum  number  of  llinks  the 
user  allows  for  a  file.  if  a  file  has  unlimited  file  space,  an  " UNLMTD" 
is  shown.  Current  file  size  is  shown  under  "CURRENT  NO.  LLINKS".  The 
total  number  of  times  a  file  has  been  allocated  since  its  creation  is 
shown  under  "NUMBER  OF  ALLOCATES". 

3. 3. 1.5  PCN  SQ038-R0 5 ,  PERM  DISK  UTILIZATION  SUMMARY.  (See  figure  3-5) 

The  report  provides  a  summary  of  the  PERM  disk  usage.  The  "AS  OF"  date 
shows  the  date  the  data  base  was  collected.  The  UMCs  along  with  their 
attributes  are  listed.  The  maximum  amount  of  space  allowed  for  user's 
files  is  shown  under  "LLINKS  ASSIGNED”.  A  "+"  next  to  the  column 
indicates  unlimited  file  space  available  to  that  UMC.  The  actual  amount 
of  space  used  is  shown  under  "LLINKS  ALLOCATED".  The  "PERCENT 
ALLOCATED"  is  the  percentage  of  total  space  available  that  is  actually 
occupied  by  files.  The  "SINCE"  data  is  computed  by  subtracting  the 
number  of  days  entered  on  card  format  two  from  the  "AS  OF"  date.  The 
"PERCENT  USED"  column  shows  the  percentage  of  total  llinks  allocated 
that  have  been  used  after  the  "SINCE"  date.  The  "ACTIVE  LLINKS"  is  the 
total  amount  of  space  that  has  been  accessed  after  the  "SINCE"  date. 
Cummulative  totals,  if  desired,  are  available  by  a  UMC,  staff 
organization  and  command.  The  line  highlighted  by  the  is  the  totals 

for  the  staff  agency.  The  line  highlighted  by  the  "****"  is  the  totals 
by  command.  Miscellaneous  and  system  totals  are  given  at  the  end  of  the 
report.  Additional  information  is  available  in  paragraph  3. 3. 2. 2  about 
the  totals  breakdown  for  commands  and  staff  organizations. 
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3.3. 1.6  PCN  SQ038-R06,  REMOVABLE  DISK  UTILIZATION  SUMMARY.  (See  figure 
3-6)  The  report  provides  summary  information  about  removable  disk 
packs.  The  UMCs  are  listed  with  the  pack  name  and  the  amount  of  space 
occupied  by  the  users*  files.  The  activity  of  the  files  is  also  broken 
down  among  three  usage  periods  showing  the  number  of  active  little 
links.  To  the  right  of  this  is  an  organization  summary  of  the  space  and 
activity  for  each  period.  Under  the  broken  line,  staff  organizations 
are  found  where  the  same  UMCs  are  associated  to  one  staff  office.  Card 
format  six,  paragraph  3. 2. 1.4,  is  used  to  associate  unique  UMCs  to  a 
standard  UMC.  The  default  is  to  group  the  UMCs  together  into  a 
miscellaneous  category  for  organization,  command,  and  system  totals. 

Card  format  four,  command  association  input,  will  cause  identical  UMCs 
to  be  grouped  together  and  organization  totals  given  using  character 
three  through  five  of  the  UMCs  as  the  organizational  symbol.  Command 
totals  will  then  follow  for  all  applicable  UMCs.  Other  UMCs  will  be 
grouped  into  the  miscellaneous  category  for  organization  and  command 
total s . 

3. 3. 1.7  PCN  SQ038-R07 ,  H6000  DISK  STATUS  SUMMARY.  (see  figure  3-7)  This 
report  provides  a  summary  of  the  file  space  on  the  system  and  how  it  is 
being  used.  File  space  is  divided  into  three  categories:  "ASSIGNED", 
"ALLOCATED"  and  "AVAILABLE".  Under  these  categories  is  the  "PERCENT 
ALLOCATED”  which  is  the  percent  of  the  assigned  file  space  which  is 
allocated.  If  card  format  four,  command  association  input,  is  used,  the 
totals  will  be  given  for  each  category  by  command.  Otherwise,  all  file 
space  statistics  will  be  grouped  as  miscellaneous. 

3. 3. 1.8  PCN  SQ038-R08,  LIST  OF  USER  MASTER  CATALOGS.  (See  figure  3-8) 
The  report  provides  a  list  of  all  UMCs  with  assigned  file  space.  The 
"AS  OF"  date  is  the  date  the  data  base  was  collected.  The  report  show 
"  LLINKS  LIMIT"  which  is  the  maximum  space  allowed  for  the  UMCs  files. 

A  UMC  with  unlimited  file  space  will  have  the  current  space  occupied 
followed  immediately  by  a  "+".  The  "CURRENT  LLINKS"  is  the  space 
occupied  by  the  files  of  the  UMC.  The  "FMS  OVERHEAD"  is  the  amount  of 
space  required  by  FMS  to  manage  the  file  structure.  If  card  format 
four,  command  association  input,  is  used,  the  totals  will  be  given  for 
each  command.  Otherwise,  all  UMC  statistics  will  be  grouped  as 
miscellaneous.  Also,  any  unique  UMCs  must  be  associated  with  a  standard 
UMC  on  card  format  six,  unique  UMC  association,  or  all  unique  UMCs  will 
be  grouped  as  miscellaneous. 

3. 3. 1.9  PCN  SQ038-R09,  OLD  FILES  DELETED.  (See  figure  3-9)  The  report 
provides  a  list  of  catalog/file  strings  deleted  between  two  executions 
of  the  catalog/file  descriptor  monitor  (EKM4F0) .  The  "AS  OF"  date  is 
the  date  of  collection  for  the  latest  data  base.  File  attributes  are 
also  given  as  shown  by  the  column  headings.  Spaces  under  "NUMBER  OF 
ALLOCATES"  indicate  zero  allocates. 

3.3.1.10  PCN  SQ038-R10,  NEW  FILES  CREATED.  (See  figure  3-10)  The 
report  provides  a  list  of  catalog/file  strings  created  between  two 
executions  of  EKM4F0.  The  "AS  OF*  date  is  the  date  of  collection  for 
the  latest  data  base.  File  attributes  are  also  given  as  shown  by  the 
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column  headings.  Spaces  under  "NUMBER  OF  ALLOCATES"  indicate  zero 
allocations . 

3.3.1.11  PCN  SQ038-R1 1 ,  PACK  ALLOCATION  REPORT.  (See  figure  3-11)  The 
report  provides  a  summary  for  both  removable  and  fixed  files  creation. 
Fixed  devices  are  grouped  together  and  shown  under  "DEVICE"  as  "FIXED". 
For  removable,  the  pack  name  is  given  under  the  "DEVICE"  column.  The 
"MONTHLY  ALLOCATION  RATE"  is  given  for  fixed  and  each  pack.  "CURRENT 
NUMBER  LLINKS"  is  the  amount  of  file  space  occupied  on  the  device. 
"MAXIMUM  NUMBER  LLINKS"  is  the  amount  of  file  space  that  would  be 
occupied  if  all  files  on  the  device  grew  to  their  maximum  size.  "NUMBER 
OF  UNLIMITED  FILES"  is  the  number  of  files  that  can  grow  to  the  maximum 
allowed  to  the  UMC. 

3.3.1.12  PCN  SQ038-R1 2 ,  CATALOG  ALLOCATION  REPORT.  (See  figure  3-12) 

The  report  provides  a  statistical  summary  of  usage  by  UMC  subdivided 
into  level  one  catalogs.  The  "FILE  CREATION  DATES"  heading  shows  the 
creation  date  of  the  earliest  and  latest  files  in  the  data  base.  The 
UMC  along  with  any  level  one  catalogs,  if  applicable,  is  given. 
Statistics  for  quick  access  files  for  a  UMC  will  be  indicated  by  spaces 
under  the  "LEVEL-1  CATALOG"  heading.  A  Clink  rate  along  with  current 
and  maximum  number  of  llinks  is  also  given. 

3.3.1.13  PCN  SQ038-R13,  FILE  ALLOCATION  REPORT.  (See  figure  3-13)  The 
report  provides  by  catalog  file  string  a  monthly  allocation  rate  for 
each  file.  The  "FILE  CREATION  DATES"  heading  shows  the  dates  from  the 
oldest  file  to  the  most  re  ent.  The  files  are  listed  according  to  the 
monthly  allocation  rate  in  descending  order.  In  adjacent  columns  the 
file's  current  and  maximum  file  size  is  given.  The  "DEVICE"  column 
indicates  where  the  file  is  located.  If  the  file  is  occupying  permanent 
space,  "FIXED"  will  be  printed.  Otherwise,  the  pack  name  for  the  file 
will  be  listed. 

3.3.1.14  PCN  SQ038-R1 4 ,  DISK  MAP.  (See  figure  3-14)  This  report 
provides  an  absolute  location  map  of  files  contained  on  either  fixed  or 
removable  devices.  The  heading  indicates  which  device  is  being  mapped. 
"CYLINDER  NUMBER",  "STARTING  LLINK" ,  "ENDING  LLINK"  and  "FILE  SIZE"  are 
shown.  Adjacent  to  these  columns  is  the  catalog  file  string  for  each 
file. 

3.3.1.15  PCN  SQ038-R1 5,  PARAMETER  CARD  ERROR  LIST.  (See  figure  3-15) 

The  report  is  a  list  of  the  parameter  cards  entered  into  EKM5FO.  If  a 
parameter  card  is  in  error,  a  message  will  be  given  immediately  below 

i  t . 

3.3.1.16  PCN  SQ038-R16,  INPUT  RECORDS/PARAMETER  CARDS  INFORMATION.  (See 
figure  3-16)  This  report  is  produced  by  EKM3FO.  The  first  line 
provides  information  about  the  tape  number,  dates/times  of  the 
information  on  the  tape.  Under  "PARAMETER  CARDS"  is  a  list  of  che  input 
cards  with  error  messages  immediately  following.  Under  "TIME  INTERVAL 
ANALYSIS"  a  breakdown  of  start-stop  dates/times  is  given  for  each 
report.  After  the  interval  analysis,  the  "PRINT  INTERVAL"  used  to 
generate  the  Detail  Report  is  given.  Next  is  the  print  suppression 
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option  used  for  the  Detail  Report.  The  “NODUPS  IS  F"  statements 
indicate  no  suppressing  of  printing  while  “NODUPS  IS  T"  indicates  there 
was  suppressing  of  duplicate  print  lines.  Any  date/time  group  requested 
outside  the  available  data  on  the  tape  will  be  listed  next. 

3.3.1.17  PCN  SQ038-R17,  ERROR  LIST.  This  report  is  produced  by  EKM7F0. 
The  error  messages  are  explained  in  paragraph  3. 5. 2. 5. 

3.3.1.18  PCN  SQ038-R18,  PARAMETER  CARDS/ERROR  LIST.  This  report  lists 
the  input  parameter  cards  of  EKM8F0  along  with  any  associated  errors. 

The  errors  are  explained  in  paragraph  3. 5. 2.6. 

3.3.1.19  PCN  SQ038-R19/  INPUT  PARAMETER  CARDS  LIST.  This  report  lists 
the  input  parameter  cards  of  EKM4F0  along  with  any  associated  errors. 

The  errors  are  explained  in  paragraph  3. 5. 2. 2. 

3.3.1.20  PCN  SQ038-R20 ,  DATA  BASE  COMPARISON  ERROR  LIST.  This  report 
shows  how  many  files  were  excluded  from  processing  because  of  an  invalid 
file  creation  date. 

3.3.2  SAMPLE  OUTPUTS.  Samples  in  this  section  of  the  manual  have  been 
chosen  to  highlight  print  options  or  unusual  events  that  might  surface 
in  the  reports.  Other  reports  not  covered  in  this  section  have 
sufficient  explanation  given  in  paragraph  3.3.1. 

3. 3. 2.1  PCN  SQ038-R02,  DETAIL  BY  SPINDLE.  Figure  3-1  shows  an  example 
of  the  Spindle  Summary  Report.  The  box  on  the  right-hand  side  contains 
statics  for  all  removable  181  spindles  during  the  specified  time  period. 
The  "%  TOTAL  TIME"  is  the  percent  of  time  during  the  interval  the 
corresponding  number  of  spindles  was  available.  For  example,  there  was 
one  spindle  available  5.37%  of  the  time  while  two  spindles  were 
available  22.59%  of  the  time. 

3. 3. 2. 2  PCN  SQ038-R0 5 ,  PERM  DISK  UTILIZATION  SUMMARY.  Figure  3-5  shows 
partical  output  resulting  from  parameter  cards  used  in  figure  3-16.  The 
"UNIQUE  UMC "  card  is  used  to  associate  the  unique  UMCs  (SWAP,  PSOLVS  and 
SYSLIB)  to  the  standard  UMC  ( FOSDM ) .  The  "STAFF  AGENCIES"  card  is  used 
to  substitute  DX22  for  the  staff  organization  totals.  Otherwise,  totals 
for  the  staff  organization  would  be  listed  as  SDM .  Notice,  the  default 
for  not  using  the  "STAFF  AGENCY"  card  is  characters  3-6  of  the  UMC  as  in 
the  XOT  totals.  The  totals  by  command  are  given  at  the  bottom  of  the 
page.  To  receive  these  totals  the  "COMMANDS"  input  parameter  card  must 
be  used.  Figure  3-17  shows  the  category  in  which  all  nonstandard  User 
Master  Catalogs  not  associated  with  standard  User  Master  Catalogs  are 
summarized.  This  summary  will  always  appear  just  before  the  system 
totals . 

3.3.3  OUTPUT  VOCABULARY.  NA. 

3.4  UTILIZATION  OF  SYSTEM  OUTPUTS.  There  is  no  single  method  of 
deducing  "optimum  disk  performance"  from  DIANA  reports.  The  reports 
provide  information  which,  when  combined  with  the  disk  manager's 
knowledge  of  the  specific  system  monitored,  allow  insight  to  the  disk 
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system's  performance  under  the  site's  workload.  If  there  are  obvious 
"bottlenecks"  in  the  system,  such  as  inactive  or  misplaced  files  causing 
an  imbalance  of  PERM  to  removable  files,  DIANA  will  provide  a  strong 
indication  of  which  files  are  causing  the  problem.  The  following 
paragraphs  list  by  PCN  some  areas  to  consider  within  each  report. 

3.4.1  SPINDLE  SUMMARY  REPORT.  PCN  SQ038-R01  summarizes  the  physical 
mounts,  allocation  time  attributed  to  each  spindle,  and  provides  the 
percent  of  monitored  time  that  a  spindle  is  not  available.  Highlighted 
in  the  upper  right-hand  corner  of  the  report  is  a  parameter  showing  the 
number  of  spindles  available  for  assignment  by  the  peripheral  allocator. 
The  following  conditions  within  this  report  indicate  a  need  for 
additional  investigation: 

a.  Large  numbers  of  pack  mounts  should  cue  the  disk  manager  that 
trend  analysis  should  be  performed. 

b.  Very  few  spindles  available  for  allocation  during  the  monitored 
time  indicate  that  further  investigation  of  the  removable  spindle  system 
is  necessary.  Additional  monitoring  is  warranted  and  utilization  of  the 
trend  analysis  portion  of  DIANA  should  be  considered. 

c.  If  saturation  of  the  spindles  appears  only  during  specific  time 
periods,  rescheduling  of  some  of  the  jobs  requiring  pack  mounts  should 
be  considered  . 

3.4.2  DETAIL  BY  SPINDLE  REPORT.  PCN  SQ038-R02  furnishes  a 
time-sequenced  spindle  map  of  packs  mounted  and  packs  temporarily 
assigned  by  the  peripheral  allocator.  The  number  of  files  open  on  a 
pack  (usage)  is  displayed  by  each  mounted  pack,  and  an  asterisk  is 
displayed  next  to  packs  having  files  which  are  open  with  only  status 
connects  attributed  to  them.  Multiple  spindle  maps  will  be  produced  for 
systems  having  more  than  eight  removable  spindles.  Examination  of  this 
report  can  pinpoint  problems  surfaced  by  summary  reports.  The  following 
conditions  could  provide  insight  into  problems  occurring  within  the 
system : 

a.  Pack  numbers  which  are  frequently  mounted  and  appear  on  different 
spindles  each  time  could  indicate  that  a  conscious  effort  should  be 
attempted  to  schedule  batch  jobs  requiring  a  certain  pack  during  the 
same  time.  Also,  when  a  pack  is  called  for  within  a  job  stream,  care 
should  be  taken  to  insure  that  the  public  option  on  the  $NNNPK  card  is 
used.  This  will  allow  multiple  users  on  that  pack  when  it  is  mounted 
and  will  decrease  mounts  and  peripheral  allocator  overhead. 

b.  Packs  with  open  files  that  show  an  asterisk  beside  them  for  long 
periods  of  time  could  indicate  that  further  investigation  by  the  disk 
manager  and  the  user  is  warranted.  Optimization  of  job  scheduling  or 
the  JCL  could  decrease  the  monopolizing  of  that  spindle  by  the  pack 
identified  and  free  the  spindle  for  other  users. 

3.4.3  SUMMARY  BY  DEVICE  TYPE.  PCN  SQ038-R03  summarizes  (by  pack  number) 
the  physical  mounts,  mounted  time,  allocated  time  (time  at  least  one 
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file  was  open  to  the  pack),  and  shows  the  percentage  of  mounted  to 
allocated  time  for  each  pack  during  a  monitored  interval.  The  following 
conditions  usually  surface  problem  areas  for  disk  managers: 

a.  Packs  having  large  number  of  mounts  generally  indicate  that  high 
activity  files  reside  on  those  packs  which  require  research  to  identify 
high  use  files  that  should  be  moved  to  PERM. 

b.  Packs  with  high  allocation  time  could  be  candidates  for  the  same 
process  described  in  (a)  or  possibly  an  optimization  technique  of 
combining  packs  having  high  allocation  times. 

c.  Packs  with  low  allocate/mount  percentages  are  also  candidates  for 
file  optimization.  Investigation  of  this  and  the  other  conditions 
mentioned  can  be  accomplished  more  thoroughly  using  the  Detail  by 
Spindle  Report. 

3.4.4  ALERT  LIST.  PCN  SQ038-R04  is  produced  by  EKM5F0  and  is  initiated, 
as  are  other  reports  created  by  this  program,  for  the  purpose  of 
providing  the  disk  manager  information  with  which  to  establish 
day-to-day  control  over  disk  resources.  Information  on  inactive  PERM 
files  is  displayed  and  summarized  by  USERID.  These  reports  can  be  used 
in  the  following  ways: 

a.  Listings  pinpointing  catalog/file  strings  that  should  be  moved  to 
other  media  can  be  sent  to  the  various  users.  In  most  cases  this  aids 
the  user  in  controlling  their  own  PERM  requirements. 

b.  Listings  can  be  used  in  conjunction  with  the  Honeywell  File 
Management  System  ( FMS )  option  "Since  Restore"  which  automatically 
deletes  files  that  have  not  been  active  since  a  certain  date.  The  lists 
can  be  sent  to  the  user  to  forewarn  of  files  that  will  be  removed  on  a 
certain  date.  This  will  allow  the  user  ample  time  to  access  that  file 
if  it  is  indeed  useful.  Sites  electing  to  use  this  option  can  insure 
that  inactive  files  will  not  waste  PERM  space. 

3.4.5  PERM  DISK  UTILIZATION  SUMMARY.  PCN  SQ038-R05  is  produced  by 
EKM5F0  as  discussed  in  paragraph  3.4.4.  Information  on  utilization  of 
PERM  disk  is  displayed  by  USERID,  showing  accumulated  totals  listed  by 
organization  and  system  levels.  This  report  is  useful  in  monitoring  the 
following : 

a.  Utilization  of  assigned  space  (approved  amount  of  PERM  space  to 
which  a  user  may  assign  files)  can  be  controlled  by  scrutinizing  the 
percent  allocated  column  of  the  report.  Users  with  continual 
percentages  below  the  75%  level  should  be  investigated  to  find  out  if 
their  requirements  are  still  valid.  If  the  requirement  is  no  longer 
valid,  that  space  can  be  allocated  to  another  purpose. 

b.  Activity  of  existing  files  can  be  determined  by  monitoring  the 
percent  used  and  active  llinks  columns  of  the  report.  These  columns 
provide  the  disk  manager  with  means  to  determine  if  the  user  is 
appropriately  assigning  files  to  the  correct  media.  Continual 
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percentages  below  the  75%  level  indicate  the  user  should  choose  other 
media  for  some  files.  Identification  of  these  files  can  be  accomplished 
by  using  the  trend  analysis  portion  of  DIANA. 

3.4.6  REMOVABLE  DISK  UTILIZATION  SUMMARY.  PCN  SQ038-R06  is  produced  by 
EKM5FO  to  provide  the  disk  manager  information  with  which  to  monitor 
removable  disk  pack  assignments.  This  report  provides  the  total  number 
of  LLINKS  residing  on  a  specific  pack,  displayed  by  activity  periods  and 
summarized  by  USERID,  organization,  and  system.  The  following 
conditions  usually  indicate  problem  areas: 

a.  Packs  having  a  large  number  of  blocks  accessed  within  a  30-day 
period  should  be  investigated  using  the  Removable  PACK  Monitor  (as 
indicated  in  attachment  1)  to  determine  if  a  problem  exists.  If  a 
problem  does  exist,  optimization  of  file  placement  should  be  initiated 
using  periodic  trending  techniques  to  identify  files  which  should  be 
considered  for  placement  on  PERM  disk. 

b.  USERIDs  or  organizations  with  multiple  packs  containing  large 
amounts  of  unused  file  space  should  be  combined  on  one  pack. 

c.  Packs  with  high  amounts  of  inactive  space;  i.e.,  files  inactive 
over  90  days,  are  candidates  for  transfer  to  magnetic  tape. 

3.4.7  H6000  DISK  STATUS  SUMMARY.  PCN  SQ038-R07  is  produced  by  EKM5FO 
and  provides  an  overview  of  the  use  of  PERM  space  by  the  system  in 
summarized  form.  This  report  displays  space  used  by  system  files,  and 
by  separate  commands  and  provides  a  breakdown  of  the  space  allocated  for 
work  area  (temporary  files).  The  following  conditions  usually  indicate 
problem  areas: 

a.  Large  amounts  of  available  disk  generally  indicate  users  have 
requested  more  space  than  actually  required,  or  that  past  justifications 
for  previous  projects  are  no  longer  valid.  In  either  case,  further 
investigation  is  warranted. 

b.  Systems  continually  having  an  abundance  of  temporary  files  could 
allocate  more  space  to  PERM  or  reconfigure  and  add  an  additional 
removable  spindle.  Care  should  be  exercised  in  these  measures,  however, 
and  "minimum  work  area  available”  peaks  should  be  checked  out  using  the 
SYRUP  monitor.  SYRUP  information  should  provide  the  disk  manager  with 
the  optimum  amount  of  space  by  which  to  reduce  the  work  area. 

3.4.8  USER  MASTER  CATALOG  REPORT.  PCN  SQ038-R08  is  produced  by  EKM5F0 
to  provide  information  which  will  allow  the  disk  manager  to  effectively 
evaluate  requests  for  PERM  space.  This  report  lists  the  UMCs  and 
displays  maximum  limit,  current  space  used,  and  space  used  by  catalog 
pointers  to  that  UMC.  The  UMCs  are  then  summarized  by  command  to  which 
they  are  assigned.  This  report  is  useful  to: 

a.  Determine  if  user  PERM  space  requirements  are  current. 

b.  Identify  USERIDs  with  excessive  FMS  overhead. 
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c.  Keep  track  of  the  systems  PERM  space  assigned. 

3.4.9  OLD  FILES  DELETED  REPORT.  PCN  SQ038-R09  is  automatically  produced 
when  the  user  chooses  to  perform  trend  anax_,sis  with  EKM6FO.  This 
rapott  contains  a  list  of  files  which  have  been  removed  during  the 
selected  time  interval.  Examination  of  this  report  and  comparison  with 
PCN  SQ038-R10,  New  Files  Created  Report,  can  reveal  trends  in  user 
activity. 

3.4.10  NEW  FILES  CREATED  REPORT.  PCN  SQ038-R10  is  identical  to  the  Old 
Files  Deleted  Report  except  that  it  is  a  list  of  files  created  during 
the  trend  analysis  period  selected. 

3.4.11  PACK  ALLOCATION  REPORT.  PCN  SQ038-R11  provides  accumulated 
totals  by  pack  on  parameters  needed  to  identify  problem  areas  for 
periodic  trending.  The  following  conditions  indicate  areas  for  further 
investigation  : 

a.  Packs  with  high  monthly  allocation  rates  generally  indicate  high 
activity  files  residing  on  that  pack,  which  causes  high  contention  for 
removable  spindles.  Further  investigation  of  the  reports  within  EKM7F0 
should  identify  files  which  should  reside  on  PERM. 

b.  Packs  which  have  a  low  number  of  current  LLINKS  and  high  monthly 
allocation  rates  are  also  identified.  Combining  of  these  packs  with 
other  removable  user's  packs  could  possibly  reduce  the  number  of 
physical  packs  on  the  system  and  increase  the  odds  of  concurrent  usage 
to  that  pack,  thereby  increasing  system  efficiency  and  decreasing 
spindle  contention. 

3.4.12  CATALOG  ALLOCATION  REPORT.  PCN  SQ038-R12  provides  information  on 
level  one  catalogs  which  will  aid  the  disk  manager  in  deciding  which 
catalogs  are  candidates  for  removable  or  PERM  media.  Because  of  the 
methodology  associated  with  the  Honeywell  job  structure  it  is  not  always 
possible  to  separate  files  within  a  catalog.  Moving  one  file  does  not 
always  eliminate  unnecessary  pack  mounts.  Therefore,  entire  catalogs 
may  have  to  be  moved  to  insure  a  reduction  in  pack  mounts.  This  report 
displays  a  calculated  activity  to  file  size  (CLINK)  rate  for  each 
catalog.  CLINK  rates  for  catalogs  with  the  same  space  requirement  can 
be  compared.  Those  with  higher  rates  should  be  considered  the  better 
candidates  for  transfer  to  PERM  spindles.  There  are  exceptions  to  this 
rule  concerning  files  which  are  allocated  during  long  intervals  of  time. 
This  condition  is  generally  known  by  the  disk  manger  and  the  files  are 
usually  already  assigned  to  PERM.  The  small  percentage  of  these  files 
which  do  exist  on  packs  can  be  identified  with  continued  runs  of  DIANA 
following  the  transfer  of  previously  identified  candidates  for  PERM. 
Dealing  with  these  will  require  further  analysis  using  EKM8FO  and  GMF. 

3.4.13  FILE  ALLOCATION  REPORT.  PCN  SQ038-R13  furnishes  the  disk  manager 
a  list  of  files  sorted  by  monthly  allocation  rate.  Files  that  are 
allocated  more  often  appear  at  the  front  of  the  list  and  inactive  files 
at  the  back.  Removable  candidates  can  be  identified  by  noting  files 
with  the  higher  allocation  and  reviewing  the  "PACK"  column  of  the  report 
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which  indicates  the  pack  on  which  they  reside.  The  inactive  files  will 
be  displayed  with  zero  rates  and  'FIXED'  will  be  printed  in  the  pack 
column.  If  an  imbalance  is  noted,  the  other  reports  from  EKM7F0  should 
be  examined  to  determine  if  only  certain  files,  catalogs,  or  entire 
packs  should  be  converted  to  other  media.  The  disk  manager  should 
examine  the  purpose  of  these  files  with  users  before  any  action  is 
taken . 

3.4.14  DISK  MAP.  PCN  SQ038-R14  provides  the  user  a  list  by  catalog/file 
string  of  the  current  location  of  files  on  PERM  or  removable  disk.  This 
report  can  provide  in-depth  knowledge  of  files  when  used  in  conjunction 
with  the  Specific  File  Report  contained  in  the  Mass  Store  Monitor  of  the 
GMF. 


3.5  RECOVERY  AND  ERROR  CORRECTION  PROCEDURES.  The  error  messages  for 
each  program  module  are  recorded  on  formatted  error  listings  for  each 
occurrance.  In  order  to  minimize  costly  reruns,  most  errors  are 
considered  fatal  and  result  in  system  termination.  Exceptions  to  this 
rule  are  documented  with  each  individual  error  message.  Error 
correction  is  initiated  by  reexecuting  the  appropriate  program/activity. 

3.5.1  RECOVERY  PROCEDURES.  All  recovery  procedures  are  documented  in 
AFM  171-606,  Volume  I. 


1.5.2  ERROR  CORRECTION  PROCEDURES. 

3.5.2. 1  EKM3FO  ERROR  MESSAGES.  These  error  messages  are  possible  in 
report  PCN  SQ038-R16. 

MESSAGE  REASON 


ZERO  TIME  PERIOD 


YOUR  PRINT  INTERVAL  OF  NNN  IS 
LESS  THAN  THE  SYSTEM  INTERVAL 
OF  NNN.  PRINT  INTERVAL  SET  TO  NNN. 


The  two  date-time  groups  on  the 
"INCLUDE  FROM"  card  are  the  same. 
Check  the  date-time  groups  to 
insure  compliance  with  card  format 
one,  paragraph  3. 2. 1.2.  If  this 
condition  is  encountered,  the 
input  parameter  card  is  ignored 
and  processing  continues. 

A  warning  indicating  the  "PRINT 
INTERVAL"  specified  on  card  format 
two  of  paragraph  3. 2. 1.2  is  less 
than  the  sample  time  entered  for 
EKM1F0.  The  final  statement  shows 
what  print  interval  was  used  for 
computations . 
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MESSAGE  REASON 

NEGATIVE  TIME  PERIOD  The  "TO"  date-time  group  is  less 

than  the  "FROM"  date-time  group  on 
the  "INCLUDE"  card.  Check  tb  in¬ 
sure  date-time  groups  are  entered 
in  the  proper  order.  If  this  con¬ 
dition  is  encountered,  the  parame¬ 
ter  card  is  ignored  and  processing 
will  continue. 

OVERLAPPING  DATA/TIME  RANGES  This  message  indicates  multiple 

date-time  groups  overlapped  on  the 
"INCLUDE  FROM"  card  of  paragraph 
3. 2. 1.2.  Check  the  date-time 
groups  for  each  card  to  insure 
they  do  not  overlap  and  reexecute 
EKM3FO. 

INVALID  DATE  Include  "FROM"  or  "TO"  date  is 

invalid.  It  did  not  pass  the  date 
edit  check.  Insure  the  date  com¬ 
ply  with  paragraph  3. 2. 1.2  and 
reexecute  EKM3FO. 

INVALID  TIME  The  "INCLUDE  FROM"  or  "TO"  time  is 

invalid.  It  did  not  pass  the  time 
edit  check.  Insure  the  times  com¬ 
ply  with  paragraph  3. 2. 1.2  and 
reexecute  EKM3FO. 

INVALID  FORMAT  This  message  is  given  for  a  vari¬ 

ety  of  editing  checks.  Semicolon 
(;),  slash  (/)  ,  or  "TO"  missing 
from  card  format  one  of  paragraph 
3. 2. 1.2  will  cause  the  message. 
Also,  this  error  will  be  given  if 
the  number  of  "INCLUDE  FROM"  cards 
is  greater  than  10.  Correct  the 
errors  and  reexecute  EKM3FO. 

INVALID  PRINT  INTERVAL  The  print  interval  specified  ex¬ 

ceeds  24  hours.  Make  corrections 
and  reexecute  EKM3FO. 

INVALID  REPORT  OPTION  (NOT  SPINDLE,  Only  options  under  card  format  1, 

PACK,  DETAIL,  ALL  OR  NONE)  paragraph  3. 2. 1.1  are  allowed. 

Check  to  insure  options  specified 
comply  with  this  paragraph  and 
reexecute  th?  job. 
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MESSAGE 


REASON 


INVALID  OPTION  (NOT  INCLUDE  FROM, 
PRINT  INTERVAL  OR  NODUPS) 


The  input  card  does  not  comply 
with  any  card  formats  in  paragraph 
3. 2. 1.2.  Make  changes  and 
reexecute  EKM3FO. 


NO  TYPE  732  RECORDS 


INTERVAL  YYMMDD/HH . TTT  TO  The  selected  date-time  intervals 

YYMMDD/HH . TTT  OUTSIDE  RANGE  OF  TAPE  are  outside  the  range  of  the  input 

data  tape.  Make  corrections  and 
reexecute  EKM3FO. 

NO  TYPE  732  RECORDS  The  message  indicates  no  Type  732 

expanded  records  were  found  on  the 
input  tape.  Insure  the  start-up 
deck  has  been  properly  configured 
and  the  Type  732  records  are  being 
expanded  by  GSEP. 

NO  PACK  MONITOR  RECORDS  FOUND  The  message  indicates  no  records 

were  found.  Insure  the  start-up 
deck  has  been  properly  configured 
and  the  Type  732  records  are  being 
expanded  by  GSEP. 

3. 5. 2. 2  EKM4FO  ERROR  MESSAGES.  These  error  messages  are  possible  in  re¬ 
port  PCN  SQ038-R1 9. 


NO  PACK  MONITOR  RECORDS  FOUND 


MESSAGE 


REASON 


FIRST  CARD  NOT  FIXED,  FIRST  OR  NEXT 


The  initial  input  parameter  card 
must  contain  the  proper  control 
word  (FIXED,  FIRST  or  NEXT). 


NO  PARAMETERS  INPUT 


NO  REMOVABLE  PACK  NAME  CARD  FOUND 


NUMBER  OF  UMCS  ON  SYSTEM  EXCEEDS  500 


At  least  one  input  parameter  card 
must  be  included  with  each  execu¬ 
tion  of  this  program. 

At  least  one  pack  name  card  (card 
format  four)  must  be  input  if  the 
"NEXT"  control  word  is  specified. 

System  design  will  not  permit  pro¬ 
cessing  of  greater  than  500  UMCs . 
If  this  problem  occurs,  report  it 
to  AFDSDC/SCCA,  AUTOVON  921-4021. 


SYSTEM  CONFIGURATION  TABLE  ERROR 


An  error  has  been  detected  in  a 
GCOS  system  table.  Report  this 
problem  to  AFDSDC/SCCA,  AUTOVON 
921-4021 . 
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MESSAGE  REASON 

NO  UMC  DATA  FOUND  No  UMC  data  on  configured  PERM 

disk  is  available.  According  to 
the  GCOS  system  tables,  permanent 
disk  is  not  configured  online.  If 
problem  persists,  contact 
AFDSDC/SCCA ,  AUTOVON  921-4021. 

3. 5. 2. 3  EKM5FO  ERROR  MESSAGES.  These  error  messages  are  possible  in  re¬ 


port  PCN  SQ038-R15. 
MESSAGE 

INVALID  REPORT  SELECTION 


INVALID  OR  MISSING  DELIMITER 
(,) ,  (*) 


INVALID  REPORT  INTERVAL  SELECTION 


INVALID  PARAMETER  CARD  NAME  OR 
FORMAT 


NO  "  =  "  SIGN  FOUND  OR  WONG  NUMBER  OF 
INPUT  CHARACTERS 


ALERT  LIST  INTERVAL  OUT  OF  RANGE 


REASON 

The  card  scan  could  not  find  one 
of  the  following:  UMC,  DISK  STA¬ 
TUS,  ALERT,  PERM,  or  REMOVABLE. 
Insure  only  these  parameters  are 
on  input  card  format  one  of  para¬ 
graph  3 . 2 . 1 . 4  . 

The  card  scan  could  not  find  a  "," 
between  options  or  there  was  no 
at  the  end  of  the  card.  This 
error  is  possible  for  all  format 
cards  of  paragraph  3. 2. 1.3. 

The  card  scan  could  not  find  ei¬ 
ther  " PERM="  or  " ALERT ="  on  card 
format  two  of  paragraph  3. 2. 1.4. 

The  card  scan  looking  for  either 
the  suffix  "s-"  or  at  the  end 

of  options  such  as  "COMMANDS-"  or 
"INTERVAL-".  Make  changes  and 
reexecute  EKM5FO. 

The  card  scan  expecting  an  "="  on 
the  "COMMAND"  and  "UMC"  associa¬ 
tion  card.  This  error  is  also 
given  if  the  improper  number  of 
characters  are  used  on  either  side 
of  the  equal  sign.  Reference 
paragraph  3. 2. 1.4  for  proper  for¬ 
ma  t . 

The  alert  range  is  less  than  30 
days  and  greater  than  365. 
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MESSAGE 

PERM  UTILIZATION  SUMMARY  INTERVAL 
OUT  OF  RANGE 

INVALID  STAFF  CODE 

INVALID  STAFF  LITERAL 


INVALID  DISK  STATUS  NUMBER 

NO  DISK  STATUS  WHEN  REPORT 
PCN  SQ038-R07  REQUIRED 


INVALID  OR  NONEXISTENT  PARAMETER 
CARD  NAME 

3. 5. 2. 4  EKM6FO  ERROR  MESSAGES, 
port  PCN  SQ038-R20. 

MESSAGE 

***NO  DATA  ON  OLD  FILE 


REASON 

The  PERM  Utilization  Summary  range 
is  less  than  15  or  greater  than 
365. 

The  card  scan  expecting  five  char¬ 
acters  followed  by  an  "="  on  the 
"STAFF  AGENCY"  card.  Reference 
paragraph  3. 2. 1.4  card  format  five 
for  proper  format. 

The  card  scan  expecting  at  least 
two  but  not  more  than  six  charac¬ 
ters  following  the  "="  sign  on  the 
"STAFF  AGENCY".  For  details  see 
paragraph  3. 2. 1.4,  card  format 
five. 

The  card  scan  expecting  a  number 
less  than  nine  digits.  For  de¬ 
tails  see  paragraph  3. 2. 1.4,  card 
format  three. 

Card  format  three  of  paragraph 
3.2. 1.4  was  expected  because  of 
the  request  for  the  Disk  Status 
Report.  Reexecute  EKM5FO  with 
this  parameter. 

The  card  scan  is  expecting  one  of 
the  five  card  formats  described 
in  paragraph  3. 2. 1.4.  The  card 
associated  with  this  message  did 
not  comply  with  any  of  these  for¬ 
mats  . 

in  re- 


REASON 

No  input  records  were  found  on 
file  code  11.  Insure  tape  input 
is  from  a  successful  run  of 
EKM4F0.  If  problem  persists,  con¬ 
tact  AFDSDC/SCCA,  AUTOVON 
921-4021 . 


These  error  messages  are  possible 
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MESSAGE 

***ERROR***  INVALID  TAPE  CREATION 
DATE  IN  OLD  DATA  BASE 


***  NO  DATA  ON  NEW  FILE 


***ERROR*  **  INVALID  TAPE  CREATION 
DATE  IN  NEW  DATA  BASE 


***ERROR***  OLD/NEW  FILE  CODES 
REVERSED 


***ERROR***  P+D/NEW  DATA  GREATER 
THAN  CURRENT  DATE 


***NNN  RECORDS  SKIPPED  ON  OLD  FILE 
DUE  TO  INVALID  FILE  CREATION  DATE 


***NNN  RECORDS  SKIPPED  ON  NEW  FILE 
DUE  TO  INVALID  FILE  CREATION  DATE 


REASON 

The  first  word  of  the  first  record 
contains  an  invalid  date.  This 
date  is  the  data  base  creation 
date.  If  problem  persists,  con¬ 
tact  AFDSDC/SCCA,  AUTOVON 
921-4021 . 

No  input  records  were  found  on 
file  code  12.  Insure  tape  input 
is  from  a  successful  run  of 
EKM4FO.  If  problem  persists,  con¬ 
tact  AFDSDC/SCCA,  AUTOVON 
921-4021  . 

The  first  word  of  the  first  record 
contains  an  invalid  date.  This 
date  is  the  data  base  creation 
date.  If  problem  persists,  con¬ 
tact  AFDSDC/SCCA,  AUTOVON 
921-4021  . 

The  date  of  the  old  data  base  is 
greater  than  the  date  of  the  new 
data  base.  Reverse  the  file  codes 
11  and  12  and  reexecute  the  job. 

The  data  base  creation  date  for 
either  or  both  input  files  is 
greater  than  the  current  day.  In¬ 
sure  EKM4FO  executes  properly  and 
the  current  date  with  the  computer 
is  correct.  If  problem  persists, 
contact  AFDSDC/SCCA,  AUTOVON 
921-4021 . 

This  message  will  be  given  for 
each  execution  of  EKM5FO.  It  pro¬ 
vides  the  number  of  records 
excluded  from  computation  because 
of  the  file  creation  date  being 
invalid  . 

This  message  will  be  given  for 
each  execution  of  EKM6F0.  It  pro¬ 
vides  the  number  of  records 
excluded  from  computation  because 
of  the  file  creation  date  being 
invalid. 


3. 5. 2. 5  EKM7F0  ERROR  MESSAGES.  These  error  messages  are  possible  in  re¬ 
port  PCN  SQ038-R17. 
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MESSAGE 

NNN  RECORDS  WERE  EXCLUDED  FROM  ALLO¬ 
CATION  REPORTS  DUE  TO  INVALID  FILE 
CREATION  DATES 


NNN  RECORDS  WERE  EXCLUDED  FROM  PACK 
ALLOCATION  REPORT  DUE  TO  TABLE 
SIZE  LIMITATION 


REASON 

This  message  only  prints  when 
records  were  excluded  because  of 
date-editing  checks  for  the  file 
creation  date. 

The  message  only  prints  when 
records  were  excluded  because  moie 
than  100  packs  are  found  on  the 
input  data  base. 


3.5. 2.6  EKM8FO  ERROR  MESSAGES.  These  error  messages  are  given  in  report 
PCN  SQ038-R18. 


MESSAGE 

INVALID  DISK  DEVICE  TYPE 

INVALID  REMOVABLE  DEVICE  TYPE 

EXPECTED  ( PERM*/RMVB L* )  CARD  FORMAT 

REMOVABLE  PACK  CARDS  FEWER  OR 
GREATER  THAN  SPECIFIED 

NUMBER  OF  PACKS  OUTSIDE  RANGE 

UNEXPECTED  END  OF  FILE 

PERM*  CARD  MUST  PRECEDE  RMBVL*  CARD 


REASON 

Reference  paragraph  3. 2. 1.7, 
EKM8FO,  for  valid  PERM  disk  types 
and  correct  input  format. 

Reference  paragraph  3. 2. 1.7, 
EKM8FO,  for  valid  removable  disk 
types  and  correct  input  format. 

PERM  or  removable  control  cards 
expected.  Reference  paragraph 
3. 2. 1.7,  EKM8FO ,  for  correct  for¬ 
mat  and  instructions. 

The  number  of  removable  packs 
specified  in  the  input  parameters 
is  not  equal  to  the  number  of 
packs  to  be  mapped.  Reference 
paragraph  3. 2. 1.7,  card  formats 
two  and  three  for  instructions. 

The  number  of  removable  packs  must 
be  a  number  between  one  and  100 
inclusive. 

At  least  one  input  parameter  card 
must  be  included  with  each  execu¬ 
tion  of  this  program. 

If  permanent  disk  types  are  to  be 
mapped,  then  the  PERM*  card  must 
be  the  first  input  parameter  card. 
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MESSAGE  REASON 

ONLY  ONE  RMBVL*  CARD  PERMITTED  Multiple  "RMVBL"  cards  are  not  al¬ 

lowed.  All  removal  disk  names  may 
be  specified  on  a  single  parameter 
ca  rd . 

ONLY  ONE  PERM*  CARD  PERMITTED  Multiple  "PERM"  cards  are  not  al¬ 

lowed.  One  entry  is  sufficient  for 
all  permanent  disk  types. 


Picture  3-1.  Spindle  Summary 
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Figure  3-2.  Detail  by  Spindle 
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Figure  3-4.  Alert  List 


iOO-&5(jCS  l<jd  v  d  MV  r  (jtf  Ju  Sv  Aavt-.kfib  Me  I  IV/ Mil 


JTTwd 


ORGANIZATIONAL  TOTAL  -  »CO  123001  1Z300I 


3-34 


AFM  171-606  Vol  II 


1  February  1980 


PCN  SOO30-PO6 

Fiaure  3-6-  Removable  Disk  Utilization  Summary 


system  f  I  L  F  $ 
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USER  Master  Catalogs 


CREATION  "numbed  of'  current  wxmm 

TALOG/CATALOG/EILE/STR1NG _ DATE _ ALLOCATES _ DEVICE  NUMBER  LLINKS  NUMBER  LLINKS 


3-38 


A PM  171-606  Vol  II 


1  February  1980 


3  _j 

lx  o 


X  to 


OC  a 

3 

ci  ® 


U 


ts 


O  (M 
|*~  fM 
(M 

If-  O, 

a  o 

Ifv  00 


a  o 

UJ  UJ 
X  X 


O  <3 
UJ  UJ 
X  X 


(M  -O' 
km  «- 

Jo  ©I 

o  o 

[OO  00 


o  oj 
o  o 

00  OO 


s  ai 


o  o 

C 

*-  rsj 


O  O 
rM  *» 
O 


o 

I*-  (M 

o 

iO  Os  I 

00  iv  | 


O  A 
UJ  UJ 
X  X 


o  o 

UJ  Ul 
X  X 


o  o 
o  o 
oo  oo 


oc  oo 

O  O 


o  op  o 

oo  oofoo  00 


o  *- 

cj  w 

x  u 

a 

•V  V. 

Z  Z 

-J  -J 

*/)  VI 

o  o 
*  « 
u  u 

•V.  -v. 

*  Z 


O  © 
o  o 


>-  t— 

ui  a 
X  o 

X  X 

X  ♦- 

r  * 

3  O 


loopo 
kv  (m*a  o 


00  ao 

o  o 

jo  o 
|o  o 
eo  oo 


©  O' 

©  o 

1(0  00 


~*  tt 

CD  O 

o  r 


©  O 
Ul  ui 
X  X 

•X  »■* 

U  u. 


o  © 

Ui  Ul 

x  X 


100  OO 
f(M  O' 
I  INI  *- 

r 

o  o 

k.  oo 


1 00  o 
o  •- 
*"■ 
©  O 

I©  O' 

ioo  oo 


X>  X> 
O  >( 
A  I 

O 

V? 


3  © 

<  w 


,•*  eo 
loo  *1 
© 
|\A 

IA  Aj 
|^*  (Ml 
«c  *c 
Ui  Utl 
I-  ►- 

o  o 


oo  K» 
|(M  © 

i©  © 

•-  eo 
*-  ©> 
,00  O 
\Ul  © 
fM  Aj 

V.  V. 

ut  Ui  j 
u  *- 
o  e 
u  o 

(A  trti 


©  ©, 
Ul  Ul| 
X  X 


*-  o» 

fM  O 

T-  T— 

O  © 
(O  O 
oo  oo 


X»  ol 
*1  N. 
•«»  © 
«0  Ol 

©  Ajj 

Kl  M 

,o>  oo 

I©  Ail 


©  o 

o  w 

(A  IA 


O  Cl  O  ui 


O  © 
UJ  Ul 
X  X 


|00  oo1 
Al  Ol 

(M  **- 

o| 

o  o 


O  © 
Ul  Ull 
X  X 


I©  fM  I 
cu  fM 
fM  •- 

r  °' 

o  o 
r-  oo 


O  O' 
O'  ruj 

O  lA 

(A  ©| 
>f  sf 
iA  h- 


•J  ru| 
CT-  rsi 

00  o 


I 


kf\  4A  »A  lA  kA  »A 


I  oo  u>\ 
O  o| 
^  •— 
o  o 
o 

oo  ooj 


IA  A. 

V  All 
ia  tn| 
-O  r- 
fM  O] 
>0  A- 
fM  rv 
fM  (Ml 
M  -#i 


O  ^ 
(M  (M 
fM 

r-  0 

rv  oo1 


i«c  oo  I 

lo  Oj 

n—  ^ 

,o  ol 
o  Oj 
|oo  oof 


O  >Ol 
<s  ia' 
O  -I 
o  N. 
O  •-] 
O  fM 
|»A  00 

x*.  iaJ 


»-  w- 
o  o 
Uf  w| 


O  Oj 
Ui  Ul 
X  X 


o  — 

|«^  fM 

l*M  •- 

-  o 

O'  O 

rv  ooi 


oc  «Oi 

(A  (Vj) 
fM  O' 
r*~  e-1 
fM  Ol 
lA 

O  oo1 

(O  •“ 

lAI 


O  O 
ui  ui 
X  X 


O  ©I 
la  oi 
loo  oof 


o  o 

UJ  Ull 

x  x! 


lOiAp  O 
W  (A  lo  00 


I  lo  o 
jo  ao 

1*0  »A 


c>  olo  ojo  b 


A-  M 
X>  Ol 
O  Ol 
«jr  oo 

C  fMl 

o  ool 


o  e 

d  Cl 
*r>  ui 


XI  IV: 
IA  00 

O  o 

00  O' 
[fv  K- 


Ul  - 

Z  Irti 
O  XI 
40  tol 
to  Cl  [ 


c  j  x  X 


A  Oj 
UJ  Ul 
X  X 


„»  o 

(M  O 
O 

o 

CO  o 
Ps.  fc 


liA  Kt 

IO  *-f 
IO  — 


o  (A 
z 

ui  O 


ui  Ul 

X  ui 


o  * 

Cl  Ui 
V.  *c 
Ul  V)l 
c*  C- ' 

o  e 

W  Cl 
Ul  u. 
*- 

o  o 


o  *o 

fM  Al] 

fc 

o  o| 
o  o' 

fc  rcl 


=3 


(n 

<li  ; 


5  I 
Oj 

z  1 


ft) 

D 

O' 


HN-ft-anf  N3d  to*p«*  gl  ItROfU  |3i »0  3i»Id<  ?-ild  l«0d3«  N01i»d#t1*  »3*<j  l*»»p»  oqi  *  tidy  *t 


AFM  171-606  Vo  1  II  1  February  1980 


3-29 


Z 

*  w  r  k 
z  _>  elicit*- 
au  _j 

B  OO  *»l»  *% 

«  C  «*«•«  •  " 

(-*  *J  —  I  • 

IV  »  ll 

X 
3 


*e*  *ao38-»ii  _  cno  duse 

fiqur»  3-11.  Pack  Allocation  Report 


COG  LEVEL-1  CATALOG  ALLOCATION  RATE  CLINK  RATE  NUMBER  LL INKS  NUMBER 


Figure 


nom 

WttdOJ 


X  €  0 


?OQO 


3-46 


AFM  171-606  Vol  II 


1  February  1980 


BY  ORDER  OF  THE  SECRETARY  OF  THE  AIR  FORCE 


OFFICIAL  LEW  ALLEN,  JR.,  General,  USAF 

Chief  of  Staff 


VAN  L.  CRAWFORD,  JR.,  Colonel,  USAF 
Director  of  Administration 


AFM  171-606  Vol  II  Attachment  1  1  February  1980  Al-1 


RECOtD  LAYOUT  | 

MU  TITL* 

STATISTICAL  COLLECTION 

mcoro  nut 

cLuimeanoH 

UNCLASSIFIED 

RCt/PCN 

FILE 

USER  TYPE  732 

FILE  DESCRIPTION 

RECORD  POSITIONS 

TYPE /CL ASS  j 

SPECIAL  INSTRUCTIONS 

Standard  SCF  Header: 

(Unexpanded) 

13  Words  plus  Block  and 
Record  Control  Word 

RECORD  SIZE  (-1) 

1-3 

BINARY 

SN 

18  bits 

RECORD  TYPE 

4-6 

BINARY 

SN 

18  bits 

USER-HOST-SYSID 

7-18 

BCD 

12AN 

SERVER-HOST-SYSID 

19-30 

BCD 

12AN 

RECORD  CREATION  DATE 

31-36 

BCD 

6N 

Format:  YYMMDD 

RECORD  CREATION  TIME 

37-42 

BINARY 

SN 

Recorded  in  clock  pulses 

SNUMB 

4  3-47 

BCD 

5AN 

Unused 

48 

UNIQUE  IDENTIFIER 

49-54 

BINARY 

SN 

36  bits 

USERID 

55-66 

BCD 

12AN 

Unused 

67-68 

PROGRAM  NUMBER 

69 

BINARY 

SN 

ACTIVITY  NUMBER 

70-72 

BCD 

BAN 

Format:  -nn 

DATANET  NUMBER 

73 

BINARY 

SN 

Unused 

74-75 

TERMINAL  TYPE 

76 

BCD 

IAN 

TERMINAL  ID 

77-78 

BCD 

2AN 

User  Record  Data: 

50  four-word  Device  Data 
Sets  formatted  as  follows 

INITIAL  RECORD  ID 

79 

BINARY 

S 

1  bit  (1  =  Init.  Record) 

SAMPLE  TIME 

79-84 

BINARY 

SN 

35  bits 

Device  Data  Sets: 

85-1284 

Word  1  - 

DEVICE  NAME 

BCD 

3  AN 

MOD  LOWER  SCT+0: 

BINARY 

18  bits 

ASSIGNABLE  FLAG 

BINARY 

1  bit  (0  =  Assignable) 

AVAILABLE  FLAG 

BINARY 

1  bit  (0  =  Available) 

DEDICATED  FLAG 

BINARY 

1  bit  (0  =  Not  Dedicated) 

PRIMARY  SCT  FLAG 

BINARY 

1  bit  (0  =  Primary  SC T) 

SINGLE  FILE  FLAG 

BINARY 

1  bit  (0  =  Single  File) 

SINGLE  DEVICE 

BINARY 

1  bit  (0  =  Single  Device) 

DEVICE  TYPE 

BINARY 

6  bits 

Unused 

4  bits 

RSRVD  T&D  FLAG 

BINARY 

1  bit  (1  =  Reserved-T&D) 

TEMP  STOPPED  FLAC 

BINARY 

1  bit  (1  =  Temp  Stopped) 

Word  2  (SCT+1)  - 

USAGE  COUNT 

BINARY 

SN 

12  bits 

Unused 

1  bit 

PACK  STRUCTURE 

BINARY 

2  bits 

(cont inucd) 

AF  ro*“  1190  fmviou*  coin  on  i  am  omolctc. 
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mcoro  Tint 


STATISTICAL  COLLECTION  USER  TYPg  732  (continued) 
FILE 


FILE  DESCRIPTION 


Word  2  (SCT+1) (cont ' d) 
QUANTITY  OF  MODULES 
ABSOLUTE  ADDRESS 
OF  LLINK  TABLE 
Word  3  - 

PACK  NUMBER 
Word  4  (SCT+2)  - 
NUMBER  OF  CONNECTS 
ON  DEVICE 


nwAi.«j.nnira 


TYPE/CLASS 


BINARY 


BINARY 


cimmcATioN 

UNCLASSIFIED 


SPECIAL  INSTRUCTIONS 


3  bits 
1 18  bits 


BINARY 


6AN  Format:  Dxnn 


36  bits 


AF  ,0*M  1190  PAIVlOUf  ID  I  TIC 

WO  TO 
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A2- 


MeOM  LAYOUT 


|  Mil  TITUI 

PITMAFniJTT  /PVMAPnMTT 

KICOAO  Tlflt 

ClAlliriCATIM 

UNCLASSIFIED 

XUKD 

Re«/peN 

F  HE  DESCRIPTION 

RECORD  POSITIONS 

S  TYPE /CLASS 

SPECIAL  INSTRUCTIONS 

CURRENT  DA 

1-6 

BCD 

6AN 

Format:  YYMMDD 

FILE  CREATION  DATE 

7-12 

BCD 

6N 

Format :  YYMMDD 

CURRENT  FILE  SIZE 
(LLINKS) 

13-15 

BINARY 

SN 

18  bits 

MAXIMUM  FILE  SIZE 
(LLINKS) 

16-18 

BINARY 

SN 

18  bits 

NUMBER  OF  ALLOCATES 

19-24 

BINARY 

SN 

36  bits 

DEVICE 

25-30 

BCD 

6AN 

Literal  "FIXED"  or 
removable  pack  number 

USER  MASTER  CATALOG 
(UMC) 

31-42 

BCD 

12  AN 

LEVEL- 1  CATALOG 

43-54 

12  AN 

UMC-CAT-FILE  STRING 

55-120 

BCD 

6  6  AN 

LAST  DATE  ALLOCATED 

121-126 

BCD 

6N 

Format :  YYMMDD 

MAXIMUM  SMC  GROWTH 

SPACE  (LLINKS) 

127-132 

BINARY 

SN 

36  bits 

SPACE  DESCRIPTOR 
OVERHEAD 

133-138 

BINARY 

1 

SN 

36  bits 

SYSTEM  IDENTIFICATION 
( .CRSID) 

139-150 

! 

BCD 

12AN 

NUMBER  OF  EXTENTS 

151-156 

BINARY 

SN 

EXTENT  DESCRIPTORS 
(11  -  2-WORD  ENTRIES): 

157-288 

CURRENT  DEVICE  NAME 

BCD 

6  AN 

CURRENT  SPACE  DE¬ 
SCRIPTOR 

BINARY 

SN 

UNUSED 

289-300 

For  future  growth 
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DEPARTMENT  OF  THE  AIR  FORCE 
Headquarters  US  Air  Force 
Washington  DC  20330 

Automatic  Data  Processing  Systems  and  Procedures 
H6000  DISK  ANALYSIS  (DIANA)  SYSTEM:  Q038/EK 
USERS  MANUAL 

AFM  171-606,  volume  II,  1  February  1980,  Is  changed  as  follows: 

1.  Purpose  of  Change.  Modify  documentation  to  allow  for  parameter  input  to  EKM7F0. 

2.  Page  Insert  Changes.  New  or  revised  material  is  indicated  by  *. 


CHANGE  1 
AFM  171-606,  Vol  II 
22  May  1981 


Remove 

2- 7,  2-8 

3- 7,  3-8 
3-11,  3-12 
3-15,  3-16 
3-19,  3-20 
3-23,  3-24 
3-27,  3-28 

3.  Write-In  Changes: 


Date 

1  Feb  80 


Insert 

2- 7,  2-8 

3- 7  thru  3-8.1 
3-11  thru  3-12.1 
3-15,  3-16 
3-19,  3-20 
3-23,  3-24 
3-27,  3-28 


Page 

Paragraph 

Line 

Action 

iii 

3.3.1.17 

Change  "Error  List"  to  read  "Parameter  Card/ Error 

List". 

2-3 

2.4f 

7 

Between  words  "and"  and  "produces",  insert 

"optionally". 
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(2)  Old  Files  Deleted  Report  (PCN  SQ038-R09) .  Displays  tiles 
deleted  during  the  time  period. 

(3)  New  Files  Created  Report  (PCN  SQ038-R10) .  Displays  files  cre¬ 
ated  during  the  time  period. 

(4)  Data  Base  Comparison  Error  List  (PCN  SQ038-R20) .  Displays 
records  deleted  due  to  file  creation  dates. 

2.7.6  DISK  PACK  CAT/FILE  DATA  REDUCTION  PROGRAM.  EKM7F0  produces  remov¬ 
able  pack,  catalog,  and  file  reports  from  data  collected  by  EKM4F0  or 
from  the  merged  output  file  of  EKM6F0.  Disk  utilization  at  the  device 
and  catalog/file  level  is  determined  by  calculating  the  number  of  times 
files  associated  with  catalogs  or  devices  are  allocated. 

a.  Inputs.  Inputs  consist  of  records  produced  by  EKM4F0  or  EKM6F0 
and  user  supplied  card  input  for  report  selection.  Options  are  covered 
in  paragraph  3. 2. 1.6  of  this  manual.  Source  of  record  input  is  depen¬ 
dent  on  the  purpose  for  running  EKM7F0. 

b.  Processing.  Report  options  are  determined  by  the  user  supplied 
card  and  two  metrics  provide  the  basis  for  the  three  reports.  First, 
the  Monthly  Allocate  Rate  defined  as  the  total  number  of  times  the  file 
was  allocated  divided  by  the  number  of  days  the  file  has  been  in  exis¬ 
tence  multiplied  by  30  days  per  month.  The  second  metric  is  the  CLINK 
rate,  defined  as  10  times  the  file's  Monthly  Allocate  Rate  divided  by 
the  file  size  in  blinks.  Reports  are  then  produced  according  to 
requirements  specified. 

c.  Outputs.  Four  output  reports  are  possible. 

(1)  Pack  Allocation  Report  (PCN  SQ038-R11).  Displays  the  utiliza¬ 
tion  of  files  associated  with  a  particular  pack  number. 

(2)  Catalog  Allocation  Report  (PCN  SQ038-R12) .  Displays  the  utili¬ 
zation  of  files  by  catalog. 

(3)  File  Allocation  Report  (PCN  SQ038-R13).  Displays  files  with 
user  requested  monthly  allocation  rate. 

(4)  Parameter  Card/Error  List  (PCN  SQ038-R17) .  Displays  parameter 
card  with  any  associated  errors  and  gives  the  number  of  records,  if  any, 
excluded  from  processing. 

2.7.7  THE  DISK  MAP  PROGRAM.  EKM8F0  provides  a  map  by  catalog/file  string 
of  the  current  location  of  the  files  on  disk. 

a.  Input.  Input  is  from  the  Catalog/File  Descriptor  Monitor  (EKM4F0). 
A  card  input  file  specifies  processing  options. 

b.  Processing.  Input  is  sorted  by  physical  location  with  device  name. 
The  temporary  sorted  file  is  then  output  by  cylinder,  indicating 
starting  llink,  ending  llink,  and  file  size  for  each  catalog/file  on  a 
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particular  device,  by  name  and  type.  The  acceptable  device  types  are 
DSS1 80 ,  DSS181 ,  DSS190 ,  DSS191  and  DSS451. 

c.  Outputs.  Two  output  reports  are  produced. 

(1)  Disk  Map  Report  (PCN  SQ038-R14).  A  report  identifying  the 
location  of  each  file  residing  on  fixed  or  removable  disk. 

(2)  parameter  Cards/Error  List  (PCN  SQ038-R18) .  Provides  a  list  of 
parameter  cards  with  any  associated  errors. 
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EKM5FO  CARD  FORMAT  5 
AAAAAA=XXXXXX 


EKM5FO  CARD  FORMAT  6 
UNIQUE  UMC- 

U  U  UU  U  U  =A A A AAA A A A AAA 


After  15  The  first  five  characters  of 

a  UMC  replace  the  "AMs.  A  staff 
office  code  between  two  and  six 
characters  replace  the  "X"s. 

If  less  than  six  characters  are 
used,  blanks  will  be  in  the 
remaining  positions. 

NOTE:  Study  examples  in  para¬ 

graph  3.2.4  before  utilizing  this 
option . 

POSITION  INSTRUCTIONS 

1-11  This  card  is  used  to  associate 

nonstandard  UMCs  with  a 
standard  USERID.  standard 
USERIDS  are  covered  in  AFM  171- 
100,  Volume  II. 

After  11  In  the  format,  the  "U"s  should  be 
replaced  with  the  first  five 
letters  of  the  standard  USERID. 
The  "A"s  should  be  replaced  with 
the  nonstandard  USERIDs,  which 
may  vary  from  two  to  12  charac¬ 
ters  in  length.  Nonstandard 
USERIDs  are  then  separated  by  a 
comma  with  the  last  nonstandard 
USERID  followed  by  an  asterisk. 

Up  to  200  UMC  associations  are 
possible. 


*  Variable  Must  be  present  and  delinates 

the  end  of  parameter  card. 

3. 2. 1.5  EKM6FO.  No  staff  inputs  are  ^eded  to  execute  this  program. 

*  3. 2. 1.6  EKM7FO.  Input  to  this  program  consists  of  one  parameter  card 

which  allows  user  selection  of  output  reports.  All  options  must  be 
separated  by  a  comma  and  an  is  used  to  delineate  the  input  card. 

Options  may  be  specified  in  any  order.  The  format  is  as  follows: 

EKM7FO  CARD  FORMAT  POSITION  INSTRUCTIONS 


Any  combination  of  desired 
reports  may  be  selected.  The 
following  is  a  list  of  key  words 
and  the  PCN  reports  they 
generate : 


REPORTS- 


1-8 
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EKM7F0  CARD  FORMAT 

POSITION 

INSTRUCTIONS 

PACK 

AFTER 

8 

Produces  Pack  Allocation  Report 
( PCN  SQ038-R11)  only. 

CATALOG 

AFTER 

8 

Produces  Catalog  Allocation 
Report  (PCN  SQ038-R12)  only. 

FI LE-NNN 

AFTER 

8 

Produces  File  Allocation  Report 
(PCN  SQ038-R1 3)  only.  "NM's  in 

FI LE=NNN 

AFTER 

8 

format  should  be  replaced  with 
an  integer  specifying  a  monthly 

FILE+NNN 

AFTER 

8 

allocation  rate.  Based  upon 
specified  monthly  allocation 

rate  FI LE-NNN ,  FILE=NNN,  and 
FILE+NNN  will  list  files  less 
than  or  equal  to  NNN,  equal  to 
NNN,  or  greater  than  or  equal 
to  NNN  respectively. 

*  VARIABLE  Must  be  present  and  delin¬ 

eates  end  of  parameter  card. 

Any  or  all  options  may  be 
specified,  but  a  comma  is 
required  to  separate  the 
options.  An  asterisk  is 
required  following  the  last 
option  specified  to  indicate 
that  all  the  reports  desired 
have  been  entered. 

3. 2. 1.7  EKM8FO .  Input  to  this  program  consists  of  one  or  more  parameter 
cards  which  allow  user  selection  of  device  records  for  processing.  The 
formats  are  as  follows: 

EKM8FO  CARD  FORMAT  1  POSITION  INSTRUCTIONS 

PERM*  1-5  If  more  than  one  type  resides  on 

the  system,  the  types  (180,  181, 
190,  191,  451)  must  be  entered 
beginning  in  column  9  separated 
by  a  comma. 


NOTE:  If  this  card  is  used  it 

must  be  the  first  input  card. 


3-8.1 
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INSTRUCTIONS 

Use  this  parameter  to  map  remov¬ 
able  packs.  The  number  of  packs 
to  be  mapped  should  replace  the 
"N"s.  No  delimiter  is  required. 
This  card  is  followed  by  input 
from  card  format  three. 

INSTRUCTIONS 

The  "XXXXX Hs  should  be  replaced 
with  a  pack  name  and  the  “TTTMs 
with  the  type  of  pack.  The 
number  of  cards  with  this 
format  must  be  the  same 
number  as  entered  on  card 
format  two. 

3.2.2  COMPOSITION  RULES.  All  parameters  should  start  in  card  column  one 
unless  otherwise  specified.  Grammatical  rules  and  punctuation  that  must 
be  observed  in  order  to  prepare  input  are  covered  by  parameter  card  in 
paragraph  3.2.1. 

3.2.3  INPUT  VOCABULARY.  NA. 

3.2.4  SAMPLE  INPUTS.  Sample  inputs  are  presented  in  this  section  for 
each  program. 

3. 2. 4.1  THE  REMOVABLE  DISK  PACK  MONITOR  (EKM1FO) . 

a.  Parameter  Inputs.  After  initiation  of  the  JCL  found  in  AFM 
171-606,  Volume  I,  GCOS  will  ask  for  privity  to  be  granted.  After 
privity  is  granted  the  following  message  will  print  on  the  console: 

-  -  -  EKM1FO  IN  EXECUTION  -  -  -  ENTER  SAMPLE  TIME  (NN  SECS,  15  to  99) 

The  operator  will  then  input  a  value  from  15  to  99.  The  input  sample 
interval  is  the  time  between  snapshots  of  the  SCT.  Records  will  be 
written  to  the  SCF  according  to  this  parameter.  The  user  must  also 
provide  the  time  of  day  when  the  operator  should  terminate  the  monitor. 

3. 2.4.2  THE  REMOVABLE  DISK  PACK  DATA  REDUCTION  (EKM3F0) . 

a.  Parameter  Inputs.  A  maximum  of  10  different  time  intervals  with 
the  three  following  reports  are  possible  per  XSCF  tape:  Spindle  Summary 
( PCN  SQ038-R01),  Detail  By  Spindle  (PCN  SQ038-R02) ,  and  Summary  By 
Device  Type  (PCN  SQ038-R03).  The  absence  of  any  parameter  cards  will 


EKM8F0  CARD  FORMAT  2 


POSITION 


RMV8L* 

NNN 


1-6 

9-12 


EKM8FO  CARD  FORMAT  3 


POSITION 


XXXXX 

TTT 


1-5 

9-11 
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(3)  In  this  example,  card  format  three  is  used  to  input  three 
values,  which  the  user  must  supply  to  produce  PCN  SQ038-R07.  Total 
available  llinks  on  the  system  has  been  entered  as  258,000,  the  amount 
of  space  used  by  system  files  is  48,000  llinks,  and  temporary  work  space 
has  been  set  at  99,500  llinks. 

Example: 

DISK  STATUS-AVAILABLE  LLINKS=258000 , SYSTEM  FILES=48000* 

DISK  STATUS-WORK  AREA=99500* 

(4)  In  this  example,  card  format  five  provides  command  breaks  for 
PCN  SQ038-R05 ,  PCN  SQ038-R06,  PCN  SQ038-R07,  and  PCN  SQ038-R08.  It  also 
provides  a  command  name  to  be  substituted  for  command  code  for  report 
purposes . 


Example: 

COMMANDS-FO=DSDC , FK=AU* 

(5)  In  this  example,  card  format  six  provides  names  which  are 
substituted  for  organizational  totals  in  PCN  SQ038-R05  and  PCN 
SQ038-R06. 


Example : 

STAFF  AGENC I ES-FKCSC=ACSC , FKAIC=AI/FOS* 

STAFF  AGENC I ES-FOPGC=PHASE4* 

STAFF  AGENCI ES-FKRTC=ROTC , F0SDT=SDS , FKLMD=LMDC* 

(6)  In  this  example,  card  format  seven  is  used  to  associate 
nonstandard  USERIDs  to  standard  USERIDs.  This  allows  all  the  attributes 
of  a  nonstandard  USERID  to  be  accumulated  under  a  specified  UMC. 

Example : 

UNIQUE  UMC-FOPRD=WORD-PROC , SARA-H , TAPELI BR* 

UNIQUE  UMC-FOSDM=SWAP , FOSDAA, DATAMGT, PSOLUS , SYS LIB* 

3. 2. 4. 5  THE  DISK  INTERVAL  UTILIZATION  PROGRAM  (EKM6FO). 
a.  No  parameter  inputs  are  required. 

3. 2. 4. 6  THE  DISK  PACK  CATALOG/FILE  DATA  REDUCTION  PROGRAM  ( EKM7FO) . 

a.  Parameter  Inputs.  Input  to  this  program  consists  of  a  single 
parameter  card  which  allows  user  selection  of  output  reports. 
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(1)  In  the  example  below  all  reports  will  be  generated.  The  File 
Allocation  Report  (PCN  SQ038-R13)  will  be  produced  for  all  files  with  a 
monthly  allocation  rate  greater  than  or  equal  to  20. 

Example: 

REPORTS-PACK , FI LE+20 , CATALOG  * 


(2)  In  the  example  below  the  File  Allocation  Report  (PCN 
SQ038-R13)  will  be  produced  for  all  files  with  a  monthly  allocation  rate 
less  than  or  equal  to  5. 

Example: 


REPORTS -F I LE- 5* 

3. 2.4.7  THE  DISK  MAP  PROGRAM  ( EKM8F0) . 

a.  Parameter  Inputs.  Inputs  to  this  program  specify  which  devices  on 
PERM  or  which  removable  packs  are  to  be  mapped. 

(1)  In  the  following  example  the  user  has  specified  for  all  181 
and  451  PERM  disk  to  be  mapped,  along  with  two  removable  packs  for  each 
of  these  type  devices: 

Example : 


PERM* 

RMVBL* 

DP001 

DP002 

DP003 

DP004 


181,451 

4 

181 

181 

451 

451 


(2)  In  the  following  example  the  user  has  specified  that  only  the 
PERM  disk  be  mapped: 

Example: 

PERM* 

(3)  In  the  following  example  the  user  has  specified  that  only  two 
removable  packs  be  mapped: 


Example: 


RMVBL*  2 
DP001  451 

DP002  191 
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3.3  OUTPUT  REQUIREMENTS.  Output  requirements  vary  depending  on  the 
purpose  and  the  amount  of  data  the  user  has  chosen  to  examine.  The  two 
monitors,  EKM1F0  and  EKM4F0,  generate  data  records.  These  records  are 
then  input  into  the  appropriate  data  reduction  program  for  desired 
reports.  The  use  of  these  reports  is  discussed  in  detail  in  paragraph 
3.4.. 

3.3.1  OUTPUT  FORMATS. 

3. 3. 1.1  PCN  SQ038-R01 ,  SPINDLE  SUMMARY  REPORT.  (See  figure  3-1)  This 
report  provides  a  summarized  list,  by  spindle  type  and  name,  of  the 
number  of  packs  mounted,  allocated  time  (time  pack  was  mounted  and  user 
files  were  open) ,  and  percent  of  time  that  a  spindle  was  allocated  over 
a  time  interval.  The  number  of  spindles  available  for  assignment  by  the 
peripheral  allocator  during  the  sample  period  is  shown  in  the  upper 
right-hand  corner  of  the  report.  The  trailer  contains  information  about 
the  sequence  of  produced  reports.  "SECTIONS"  correspond  to  the  order 
and  number  of  reports  within  the  requested  intervals.  "PART" 
corresponds  to  the  different  types  of  devices  included  within  the 
report. 

3. 3. 1.2  PCN  SQ038-R02,  DETAIL  BY  SPINDLE  REPORT.  (See  figure  3-2)  This 
report  provides  a  detailed  look  at  activity  occurring  on  each  spindle 
configured  for  removable  packs.  Directly  under  each  spindle  name  the 


i 


i 
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column  headings.  Spaces  under  "NUMBER  OF  ALLOCATES"  indicate  zero 
allocations. 

3.3.1.11  PCN  SQ038-R11,  PACK  ALLOCATION  REPORT.  (See  figure  3-11)  The 
report  provides  a  summary  for  both  removable  and  fixed  files  creation. 
Fixed  devices  are  grouped  together  and  shown  under  "DEVICE"  as  "FIXED”. 
For  removable,  the  pack  name  is  given  under  the  "DEVICE”  column.  The 
"MONTHLY  ALLOCATION  RATE"  is  given  for  fixed  and  each  pack.  "CURRENT 
NUMBER  LLINKS "  is  the  amount  of  file  space  occupied  on  the  device. 
“MAXIMUM  NUMBER  LLINKS"  is  the  amount  of  file  space  that  would  be 
occupied  if  all  files  on  the  device  grew  to  their  maximum  size.  "NUMBER 
OF  UNLIMITED  FILES"  is  the  number  of  files  that  can  grow  to  the  maximum 
allowed  to  the  UMC. 

3.3.1.12  PCN  SQ038-R12,  CATALOG  ALLOCATION  REPORT.  (See  figure  3-12) 

The  report  provides  a  statistical  summary  of  usage  by  UMC  subdivided 
into  level  one  catalogs.  The  "FILE  CREATION  DATES"  heading  shows  the 
creation  date  of  the  earliest  and  latest  files  in  the  data  base.  The 
UMC  along  with  any  level  one  catalogs,  if  applicable,  is  given. 
Statistics  for  quick  access  files  for  a  UMC  will  be  indicated  by  spaces 
under  the  "LEVEL-1  CATALOG"  heading.  A  Clink  rate  along  with  current 
and  maximum  number  of  llinks  is  also  given. 

3.3.1.13  PCN  SQ038-R13,  FILE  ALLOCATION  REPORT.  (See  figure  3-13)  The 
report  provides  by  catalog  file  string  a  list  of  those  files  having  user 
requested  monthly  allocation  rate.  The  "FILE  CREATION  DATES"  heading 
shows  the  dates  from  the  oldest  file  to  the  most  recent.  The  files  are 
listed  according  to  the  monthly  allocation  rate  in  descending  order.  In 
adjacent  columns  the  file's  current  and  maximum  file  size  is  given.  The 
"DEVICE"  column  indicates  where  the  file  is  located.  If  the  file  is 
occupying  permanent  space,  "FIXED"  will  be  printed.  Otherwise,  the  pack 
name  tor  the  file  will  be  listed. 

3.3.1.14  PCN  SQ038-R14,  DISK  MAP.  (See  figure  3-14)  This  report 
provides  an  absolute  location  map  of  files  contained  on  either  fixed  or 
removable  devices.  The  heading  indicates  which  device  is  being  mapped. 
"CYLINDER  NUMBER",  "STARTING  LLINK" ,  "ENDING  LLINK"  and  "FILE  SIZE"  are 
shown.  Adjacent  to  these  columns  is  the  catalog  file  string  for  each 
file. 

3.3.1.15  PCN  SQ038-R15,  PARAMETER  CARD  ERROR  LIST.  (See  figure  3-15) 

The  report  is  a  list  of  the  parameter  cards  entered  into  EKM5FO.  If  a 
parameter  card  is  in  error,  a  message  will  be  given  immediately  below 
it. 

3.3.1.16  PCN  SQ038-R16,  INPUT  RECORDS/PARAMETER  CARDS  INFORMATION.  (See 
figure  3-16)  This  report  is  produced  by  EKM3FO.  The  first  line 
provides  information  about  the  tape  number,  dates/times  of  the 
information  on  the  tape.  Under  "PARAMETER  CARDS"  is  a  list  of  the  input 
cards  with  error  messages  immediately  following.  Under  "TIME  INTERVAL 
ANALYSIS"  a  breakdown  of  start-stop  dates/times  is  given  for  each 
report.  After  the  interval  analysis,  the  "PRINT  INTERVAL"  used  to 
generate  the  Detail  Report  is  given.  Next  is  the  print  suppression 


3-16 


APM  171-606  Vo  1  II  (Cl) 


22  May  1981 


option  used  for  the  Detail  Report.  The  "NODUPs  IS  F"  statements 
indicate  no  suppressing  of  printing  while  “NODUPS  IS  TM  indicates  there 
was  suppressing  of  duplicate  print  lines.  Any  date/time  group  requested 
outside  the  available  data  on  the  tape  will  be  listed  next. 

3.3.1.17  PCN  SQ038-R17,  PARAMETER  CARD/ERROR  LIST.  This  report  is 
produced  by  EKM7FO.  The  error  messages  are  explained  in  paragraph 

3. 5.2. 5. 

3.3.1.18  PCN  SQ038-R18,  PARAMETER  CARDS/ERROR  LIST.  This  report  lists 
the  input  parameter  cards  of  EKM8F0  along  with  any  associated  errors. 

The  errors  are  explained  in  paragraph  3. 5. 2. 6. 

3.3.1.19  PCN  SQ038-R19,  INPUT  PARAMETER  CARDS  LIST.  This  report  lists 
the  input  parameter  cards  of  EKM4F0  along  with  any  associated  errors. 

The  errors  are  explained  in  paragraph  3. 5.2.2. 

3.3.1.20  PCN  SQO 38-R20 ,  DATA  BASE  COMPARISON  ERROR  LIST.  This  report 
shows  how  many  files  were  excluded  from  processing  because  of  an  invalid 
file  creation  date. 

3.3.2  SAMPLE  OUTPUTS.  Samples  in  this  section  of  the  manual  have  been 
chosen  to  highlight  print  options  or  unusual  events  that  might  surface 
in  the  reports.  Other  reports  not  covered  in  this  section  have 
sufficient  explanation  given  in  paragraph  3.3.1. 

3. 3.2.1  PCN  SQO  38 -R0  2 ,  DETAIL  BY  SPINDLE.  Figure  3-1  shows  an  example 
of  the  Spindle  Summary  Report.  The  box  on  the  right-hand  side  contains 
statics  for  all  removable  181  spmdits  during  the  specified  time  period. 
Tne  "%  TOTAL  TIME"  is  the  percent  oi  time  during  the  interval  the 
corresponding  number  of  spindles  was  available.  For  example,  there  was 
one  spindle  available  5.37%  of  the  time  while  two  spindles  were 
available  22.59%  of  the  time. 

3. 3. 2. 2  PCN  SQ038-R05,  PERM  DISK  UTILIZATION  SUMMARY.  Figure  3-5  shows 
partical  output  resulting  from  parameter  cards  usea  in  figure  3-16.  The 
"UNIQUE  UMC "  card  is  used  to  associate  the  unique  UMCs  (SWAP,  PSOLVS  and 
SYSLIB)  to  the  standard  UMC  ( FOSDM ) .  The  “STAFF  AGENCIES"  card  is  used 
to  substitute  0X22  for  tne  staff  organization  totals.  Otherwise,  totals 
for  the  staff  organization  would  be  listed  as  SDM .  Notice,  the  default 
for  not  using  the  "STAFF  AGENCY"  card  is  characters  3-6  of  the  UMC  as  in 
the  XOT  totals.  The  totals  by  command  are  given  at  the  bottom  of  the 
page.  To  receive  these  totals  the  "COMMANDS"  input  parameter  card  must 
be  used.  Figure  3-17  shows  the  -ategory  in  which  all  nonstandard  User 
Master  Catalogs  not  associated  with  standard  User  Master  Catalogs  are 
summarized.  This  summary  will  always  appear  just  before  the  system 
totals. 

3.3.3  OUTPUT  VOCABULARY.  NA. 

3.4  UTILIZATION  OF  SYSTEM  OUTPUTS.  There  is  no  single  method  of 
deducing  "optimum  disk  performance"  from  DIANA  reports.  The  reports 
provide  information  which,  when  combined  with  the  disk  manager's 
knowledge  of  the  specific  system  monitored,  allow  insight  to  the  disk 
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percentages  below  the  75%  level  indicate  the  user  should  choose  other 
media  for  some  files.  Identification  of  these  files  can  be  accomplished 
by  using  the  trend  analysis  portion  of  DIANA. 

3.4.6  REMOVABLE  DISK  UTILIZATION  SUMMARY.  PCN  SQ038-RQ6  is  produced  by 
EKMSFO  to  provide  the  disk  manager  information  with  which  to  monitor 
removable  disk  pack  assignments.  This  report  provides  the  total  number 
of  LLINKS  residing  on  a  specific  pack,  displayed  by  activity  periods  and 
summarized  by  USERID,  organization,  and  system.  The  following 
conditions  usually  indicate  problem  areas: 

a.  Packs  having  a  large  number  of  blocks  accessed  within  a  30-day 
period  should  be  investigated  using  the  Removable  PACK  Monitor  (as 
indicated  in  attachment  1)  to  determine  if  a  problem  exists.  If  a 
problem  does  exist,  optimization  of  file  placement  should  be  initiated 
using  periodic  trending  techniques  to  identify  files  which  should  be 
considered  for  placement  on  PERM  disk. 

b.  USERIDs  or  organizations  with  multiple  packs  containing  large 
amounts  of  unused  file  space  should  be  combined  on  one  pack. 

c.  Packs  with  high  amounts  of  inactive  space;  i.e.,  files  inactive 
over  90  days,  are  candidates  for  transfer  to  magnetic  tape. 

3.4.7  H6000  DISK  STATUS  SUMMARY.  PCN  SQ038-R07  is  produced  by  EKM5FO 
and  provides  an  overview  of  the  use  of  PERM  space  by  the  system  in 
summarized  form.  This  report  displays  space  used  by  system  files,  and 
by  separate  commands  and  provides  a  breakdown  of  the  space  allocated  for 
work  area  (temporary  files).  The  following  conditions  usually  indicate 
problem  areas: 

a.  Large  amounts  of  available  disk  generally  indicate  users  have 
requested  more  space  than  actually  required,  or  that  past  justifications 
for  previous  projects  are  no  longer  valid.  In  either  case,  further 
investigation  is  warranted. 

b.  Systems  continually  having  an  abundance  of  temporary  files  could 
allocate  more  space  to  PERM  or  reconfigure  and  add  an  additional 
removable  spindle.  Care  should  be  exercised  in  these  measures,  however, 
and  "minimum  work  area  available"  peaks  should  be  checked  out  using  the 
SYRUP  monitor.  SYRUP  information  should  provide  the  disk  manager  with 
the  optimum  amount  of  space  by  which  to  reduce  the  work  area. 

3.4.8  USER  MASTER  CATALOG  REPORT.  PCN  SQ038-R08  is  produced  by  EKM5F0 
to  provide  information  which  will  allow  the  disk  manager  to  effectively 
evaluate  requests  for  PERM  space.  This  report  lists  the  UMCs  and 
displays  maximum  limit,  current  space  used,  and  space  used  by  catalog 
pointers  to  that  UMC.  The  UMCs  are  then  summarized  by  command  to  which 
they  are  assigned.  This  report  is  useful  to: 

a.  Determine  if  user  PERM  space  requirements  are  current. 

b.  Identify  USERIDs  with  excessive  FMS  overhead. 
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c.  Keep  track  of  the  systems  PERM  space  assigned. 

3.4.9  OLD  FILES  DELETED  REPORT.  PCN  SQ038-R09  is  automatically  produced 
when  the  user  chooses  to  perform  trend  analysis  with  EKM6F0.  This 
report  contains  a  list  of  files  which  have  been  removed  during  the 
selected  time  interval.  Examination  of  this  report  and  comparison  with 
PCN  SQ038-R10,  New  Files  Created  Report,  can  reveal  trends  in  user 
activity. 

3.4.10  NEW  FILES  CREATED  REPORT.  PCN  SQ038-R10  is  identical  to  the  Old 
Files  Deleted  Report  except  that  it  is  a  list  of  files  created  during 
the  trend  analysis  period  selected. 

3.4.11  PACK  ALLOCATION  REPORT.  PCN  SQ038-R11  provides  accumulated 
totals  by  pack  on  parameters  needed  to  identify  problem  areas  for 
periodic  trending.  The  following  conditions  indicate  areas  for  further 
investigation : 

a.  Packs  with  high  monthly  allocation  rates  generally  indicate  high 
activity  files  residing  on  that  pack,  which  causes  high  contention  for 
removable  spindles.  Further  investigation  of  the  reports  within  EKM7FO 
should  identify  files  which  should  reside  on  PERM. 

b.  Packs  which  have  a  low  number  of  current  LLINKS  and  high  monthly 
allocation  rates  are  also  identified.  Combining  of  these  packs  with 
other  removable  user's  packs  could  possibly  reduce  the  number  of 
physical  packs  on  the  system  and  increase  the  odds  of  concurrent  usage 
to  that  pack,  thereby  increasing  system  efficiency  and  decreasing 
spindle  contention. 

3.4.12  CATALOG  ALLOCATION  REPORT.  PCN  SQ038-R12  provides  information  on 
level  one  catalogs  which  will  aid  the  disk  manager  in  deciding  which 
catalogs  are  candidates  for  removable  or  PERM  media.  Because  of  the 
methodology  associated  with  the  Honeywell  job  structure  it  is  not  always 
possible  to  separate  files  within  a  catalog.  Moving  one  file  does  not 
always  eliminate  unnecessary  pack  mounts.  Therefore,  entire  catalogs 
may  have  to  be  moved  to  insure  a  reduction  in  pack  mounts.  This  report 
displays  a  calculated  activity  to  file  size  (C LINK)  rate  for  each 
catalog.  CLINK  rates  for  catalogs  with  the  same  space  requirement  can 
be  compared.  Those  with  higher  rates  should  be  considered  the  better 
candidates  for  transfer  to  PERM  spindles.  There  are  exceptions  to  this 
rule  concerning  files  which  are  allocated  during  long  intervals  of  time. 
This  condition  is  generally  known  by  the  disk  manager  and  the  files  are 
usually  already  assigned  to  PERM.  The  small  percentage  of  these  files 
which  do  exist  on  packs  can  be  identified  with  continued  runs  of  DIANA 
following  the  transfer  of  previously  identified  candidates  for  PERM. 
Dealing  with  these  will  require  further  analysis  using  EKM8FO  and  GMF. 

*  3.4.13  FILE  ALLOCATION  REPORT.  PCN  SQ038-R13  furnishes  the  disk 

manager  a  list  of  those  files  meeting  the  monthly  allocation  rate 
parameter  input  to  EKM7FO.  Files  that  are  allocated  more  often  appear 
at  the  front  of  the  list  and  inactive  files  at  the  back.  Removable 
candidates  can  be  identified  by  noting  files  with  the  higher  allocation 
and  reviewing  the  "PACK"  column  of  the  report 
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MESSAGE 

INVALID  OPTION  (NOT  INCLUDE  FROM, 
PRINT  INTERVAL  OR  NODUPS) 


INTERVAL  YYMMDD/HH . TTT  TO 
YYMMDD/HH . TTT  OUTSIDE  RANGE  OF  TAPE 


REASON 

The  input  card  does  not  comply 
with  any  card  formats  in  paragraph 
3. 2. 1.2.  Make  changes  and 
reexecute  EKM3FO. 

The  selected  date-time  intervals 
are  outside  the  range  of  the  input 
data  tape.  Make  corrections  and 
reexecute  EKM3FO. 


NO  TYPE  732  RECORDS 


NO  PACK  MONITOR  RECORDS  FOUND 


The  message  indicates  no  Type  732 
expanded  records  were  found  on  the 
input  tape.  Insure  the  start-up 
deck  has  been  properly  configured 
and  the  Type  732  records  are  being 
expanded  by  GSEP. 

The  message  indicates  no  records 
were  found.  Insure  the  start-up 
deck  has  been  properly  configured 
and  the  Type  732  records  are  being 
expanded  by  GSEP. 


3. 5. 2. 2  EKM4FO  ERROR  MESSAGES.  These  error  messages  are  possible  in 
report  PCN  SQ038-R19. 

MESSAGE  REASON 


FIRST  CARD  NOT  FIXED,  FIRST  OR  NEXT 


NO  PARAMETERS  INPUT 


NO  REMOVABLE  PACK  NAME  CARD  FOUND 


*  NUMBER  OF  UMCS  ON  SYSTEM  EXCEEDS 
1500 


*  CAT/FILE  XXXXXXXX  IS  LINKED 
TO  DEVICE  DDD 


The  initial  input  parameter  card 
must  contain  the  proper  control 
word  (FIXED,  FIRST  or  NEXT). 

At  least  one  input  parameter  card 
must  be  included  with  each  execu¬ 
tion  of  this  program. 

At  least  one  pack  name  card  (card 
format  four)  must  be  input  if  the 
"NEXT"  control  word  is  specified. 

System  design  will  not  permit  pro¬ 
cessing  of  greater  than  1500  UMCs. 
If  this  problem  occurs,  report  it 
to  AFDCSC/SCCA ,  AUTOVON  921-4021. 

Specified  CAT/FILE  has  an  FMS 
structure  pointing  to  a  device 
currently  not  configured  on  your 
system.  CAT/FILE  will  be  ignored 
and  processing  will  continue. 


A 


3-24 


AFM  171-606  Vol  II  (Cl) 


22  May  1981 


MESSAGE  REASON 


SYSTEM  CURRENTLY  HAS  AT  LEAST 
10  FILES  LINKED  TO  INVALID 
DEVICES 


NO  UMC  DATA  FOUND 


3. 5. 2. 3  EKM5FO  ERROR  MESSAGES.  These 
report  PCN  SQ038-R15. 


At  least  10  CAT/FILES  are  point¬ 
ing  to  invalid  devices.  If  this 
problem  occurs,  report  it  to 
AFDSDC/SCCA ,  AUTOVON  921-4021. 

No  UMC  data  on  configured  PERM 
disk  is  available.  According  to 
the  GCOS  system  tables,  permanent 
disk  is  not  configured  online.  If 
problem  persists,  contact 
AFDSDC/SCCA,  AUTOVON  921-4021. 

error  messages  are  possible  in 


MESSAGE 

INVALID  REPORT  SELECTION 


INVALID  OR  MISSING  DELIMITER 

(,),  (*) 


INVALID  REPORT  INTERVAL  SELECTION 


INVALID  PARAMETER  CARD  NAME  OR 
FORMAT 


NO  SIGN  FOUND  OR  WONG  NUMBER  OF 

INPUT  CHARACTERS 


ALERT  LIST  INTERVAL  OUT  OF  RANGE 


REASON 

The  card  scan  could  not  find  one 
of  the  following:  UMC,  DISK  STA¬ 
TUS,  ALERT,  PERM,  or  REMOVABLE. 
Insure  only  these  parameters  are 
on  input  card  format  one  of  para¬ 
graph  3. 2. 1.4. 

The  card  scan  could  not  find  a  ", 
between  options  or  there  was  no 
at  the  end  of  the  card.  This 
error  is  possible  for  all  format 
cards  of  paragraph  3. 2. 1.3. 

The  card  scan  could  not  find 
either  "PERM="  or  " ALERT="  on  card 
format  two  of  paragraph  3. 2. 1.4. 

The  card  scan  looking  for  either 
the  suffix  "s-"  or  at  the  end 

of  options  such  as  "COMMANDS-"  or 
"INTERVAL-".  Make  changes  and 
reexecute  EKM5FO. 

The  card  scan  expecting  an  on 
the  "COMMAND"  and  "UMC" 
association  card.  This  error  is 
also  given  if  the  improper  number 
of  characters  are  used  on  either 
side  of  the  equal  sign.  Reference 
paragraph  3.2. 1.4  for  proper  for¬ 
mat. 

The  alert  range  is  less  than  30 
days  and  greater  than  365. 
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MESSAGE 

NNN  RECORDS  WERE  EXCLUDED  FROM  ALLO¬ 
CATION  REPORTS  DUE  TO  INVALID  FILE 
CREATION  DATES 


NNN  RECORDS  WERE  EXCLUDED  FROM  PACK 
ALLOCATION  REPORT  DUE  TO  TABLE 
SIZE  LIMITATION 


INVALID  PARAMETER  CARD  NAME  OR 
FORMAT 


DELIMITER  MISSING  OR  INVALID 
OPTION  SPECIFIED 


A  NON-NUMERIC  VALUE  OR  NO  VALUE 
ENTERED  FOR  ALLOCATION  RATE 


ILLEGAL  REPORT  OPTION 


ALLOCATION  RATE  DELIMITER  ERROR 


3. 5. 2. 6  EKM8FO  ERROR  MESSAGES.  These 
PCN  SQ038-R18. 

MESSAGE 

INVALID  DISK  DEVICE  TYPE 


INVALID  REMOVABLE  DEVICE  TYPE 


REASON 

This  message  only  prints  when 
records  were  excluded  because  of 
date-editing  checks  for  the  file 
creation  date. 

The  message  only  prints  when 
records  were  excluded  because  more 
than  100  packs  are  found  on  the 
input  data  base. 

The  card  scan  was  expecting  the 
suffix  at  the  end  of 

"REPORTS".  Make  changes  and 
reexecute. 

The  card  scan  could  not  find  a 
between  options  or  there 
was  no  at  the  end  of 

options.  An  invalid  option  can 
also  cause  this  message. 

Make  changes  and  reexecute. 

Invalid  entry  following  "FILE-", 
"FI LE=" ,  or  "FILE+" .  Make 
changes  and  reexecute. 

Only  options  under  paragraph 
3.2. 1.6  are  allowed.  Check  to 
insure  options  specified  comply 
with  this  paragraph  and  reexecute. 

The  card  scan  was  expecting  a  "+", 
or  "="  after  "FILE".  Make 
changes  and  reexecute. 

error  messages  are  given  in  report 


REASON 

Reference  paragraph  3. 2. 1.7, 
EKM8FO,  for  valid  PERM  disk  types 
and  correct  input  format. 

Reference  paragraph  3. 2. 1.7, 
EKM8FO ,  for  valid  removable  disk 
types  and  correct  input  format. 


iim^i 
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MESSAGE 

EXPECTED  <PERM*/RMVBL*)  CARD  FORMAT 

REMOVABLE  PACK  CARDS  FEWER  OR 
GREATER  THAN  SPECIFIED 

NUMBER  OF  PACKS  OUTSIDE  RANGE 

UNEXPECTED  END  OF  FILE 

r>ERM*  CARD  MUST  PRECEDE  RMBVL*  CARD 

ONLY  ONE  RMBVL*  CARD  PERMITTED 

ONLY  ONE  PERM*  CARD  PERMITTED 


REASON 

PERM  or  removable  control  cards 
expected.  Reference  paragraph 
3. 2. 1.7,  EKM8FO,  for  correct  for¬ 
mat  and  instructions. 

The  number  of  removable  packs 
specified  in  the  input  parameters 
is  not  equal  to  the  number  of 
packs  to  be  mapped.  Reference 
paragraph  3.2. 1.7,  card  formats, 
two  and  three  for  instructions. 

The  number  of  removable  packs  must 
be  a  number  between  one  and  100 
inclusive. 

At  least  one  input  parameter  card 
must  be  included  with  each  execu¬ 
tion  of  this  program. 

If  permanent  disk  types  are  to  be 
mapped,  then  the  PERM*  card  must 
be  the  first  input  parameter  card. 

Multiple  "RMVBL"  cards  are  not 
allowed.  All  removal  disk  names 
may  be  specified  on  a  single  par¬ 
ameter  card. 

Multiple  "PERM"  cards  are  not 
allowed.  One  entry  is  sufficient 
for  all  permanent  disk  types. 


